Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / LW22.ZIP;1 / LW22.INF (.txt) < prev next >

Wrap

OS/2 Help File | 1994-04-17 | 188.0 KB | 3,685 lines

‚ïê‚ïê‚ïê 1. Copyright ‚ïê‚ïê‚ïê LiveWire Communications Version 2.2 Professional Shareware Software User Manual & Script Language Reference Copyright 1990-1994 Les Novell DataMirage Software ‚ïê‚ïê‚ïê 2. Introduction ‚ïê‚ïê‚ïê Introduction LiveWire Communications is the 32-bit, multi-threaded, text-based tele-communications program for OS/2 2.0 and later. Highly optimized, packed full of features, and yet easy to use, LiveWire is an excellent replacement for DOS communications packages which are unable to take full advantage of OS/2. Features LiveWire's text-based interface is designed to be easy to use and configure, especially for users familiar with other communications software. LiveWire also has many features unavailable in other communications programs. The following is a list of major features incorporated in LiveWire 2.2. o Full TTY, ANSI, OS2You, VT-102, and 0+ Avatar emulations o Integrated REXX scripting language o Data rates up to 57,600 bps without loss of data o High performance output in windowed and full screen sessions o Unlimited scroll-back buffer o 80 preset modem configurations to choose from o Internal public domain Zmodem-32 batch with resume o Named pipe support for network modems and connections o Point and shoot dialing directory with superior editing facilities o Macro commands control the actions of most function or alternate keys; all keys are re-definable o Automatic detection and installation of external protocols such as M2Zmodem, CKermit, SEALink, and ZedZap o Support for Procomm+, Qmodem, Boyan, Telix, and LiveWire keysets. This feature is meant to decrease the time required to learn LiveWire by providing familiar keycommand definitions. o Dialing directory reads and writes Procomm, Procomm+, Qmodem, Boyan, and Telix dialing directories. o Point-and-shoot file selection, using a multi-threaded file navigator. ‚ïê‚ïê‚ïê 3. Installation ‚ïê‚ïê‚ïê Installation To install LiveWire, first copy the source files from the distribution diskette into a directory on your hard drive, for example LW22. Then, change to that directory and drive and type INSTALL. Example: C:\>mkdir LW22 C:\>A: A:\>copy *.* C:\LW22 A:\>C: C:\>cd LW22 C:\LW22>INSTALL The installation program will assume you want to install LiveWire in the directory you have copied the files to. The installation program will remove any previous residual configuration files. Next, it will create a desktop folder for LiveWire which will contain the program, this manual, a registration object, and a host mode script. Once installation has been completed, you may start LiveWire by double-clicking on the LiveWire icon. If you have a registration number you may register this copy of LiveWire by double-clicking on the LiveWire key icon. If you have the ZIPed version of LiveWire available on bulletin boards and networks world-wide, follow similar instructions, except unzip the LiveWire ZIP file into the desired directory, then run install. ‚ïê‚ïê‚ïê 4. Running LiveWire for the first time ‚ïê‚ïê‚ïê Running LiveWire for the first time The first time LiveWire is started it must be told a few things about the computer setup. The first thing LiveWire will want to know is which communications port the modem is on. If you do not know which port your modem is on you must refer to your modem or computer manual for this information. Move the highlight bar to the correct communications port using the right and left arrow keys, then press ENTER to make a selection. Next, LiveWire must know what type of modem is installed in the computer. A list of 80 different types of modems will be displayed. To choose one, use the up and down arrow keys to move through the list. Press ENTER on the modem installed. If the modem is not listed, choose "Other modem not listed." In this case, additional setup will be required. Refer to the modem manual for more information. LiveWire now needs to know the highest speed the modem will communicate at. The correct speed will already be highlighted if a pre-defined modem was selected. If "Other modem not listed" was selected the modem speed should be set according to the modem manual. Make the speed selection by moving the highlight bar to the correct speed and then press ENTER. LiveWire will now prompt for a default color scheme. To select the desired color scheme, use the arrow keys to move the highlight bar to the color scheme desired and press ENTER. Colors can later be customized. You will now be asked if you wish to emulate the keyset of several popular communications programs. If you are not familiar with any of these programs, just press ENTER. To emulate another program's keyset, use the right arrow key to move the highlight bar to the program of your choice and press ENTER. Lastly, you will be asked if you want to do some further configuration or if you want to load LiveWire at this point. To load LiveWire without any further configuration press ENTER, otherwise press the right arrow key once to move the highlight bar to Edit Configuration and then press ENTER. ‚ïê‚ïê‚ïê 5. Configuration ‚ïê‚ïê‚ïê Configuration Using pull-down menus LiveWire makes use of pull-down menus in it's configuration. Pull-down menus are designed for ease of use and brevity. Across the top of the screen are several categories of configuration. Using the right and left arrow keys on your keyboard you can move the highlight bar from one category to the next. Pressing the ENTER key or Down arrow key on one of these categories "pulls down" a menu pertaining to that category. Pressing ENTER while the highlight bar is on the Modem category causes a menu appears directly under the category. In this new menu are three options: "Port Configuration...", "Modem Commands...", and "Install new modem..." The "..." at the end of these options indicate they lead to additional nested menus. Pressing the up and down arrow keys moves the highlight bar vertically between the two options. Pressing ENTER on one of these options leads to another nested menu. Under "Modem Commands..." is the final menu in the menu nest. Listed in this menu are the several options for modem commands. Again, using the up and down arrow keys moves the highlight bar among the options. To change one of these options, move the highlight bar to the option and press ENTER. A cursor will appear at the beginning of the option which can be used to edit the field. When finished editing the field, press ENTER or ESC and the cursor will disappear. Pressing the ESC key while not editing a field causes configuration to back up one menu. If you get stuck or need a little instruction, there is one line of context-sensitive help available at the bottom of each screen called the status line. The status line contains status information and a list of available options. ‚ïê‚ïê‚ïê 5.1. Modem ‚ïê‚ïê‚ïê Modem This menu contains three sub-menus used for configuring modem setup and port setup. "Port Configuration" is a sub-menu that contains specific hardware information such as the communications port number and baud rate. "Modem Commands" contains the modem's commands and responses such as the commands that initialize the modem, dial a number, and hang up. This menu also specifies the messages LiveWire will expect the modem to respond with when it gets connected to another computer or encounters a problem. "Install Modem" will install a different modem type from the list of modems presented during initial configuration. ‚ïê‚ïê‚ïê 5.1.1. Port Configuration ‚ïê‚ïê‚ïê Port Configuration... This selection leads you to a menu where you may change any of the options below. Comm device Selecting this option allows you to change the communications port number your modem is using. Refer to your modem, computer, or communications port manual for this information. It will not hurt to try numbers successively from 1 until your modem dials successfully. If you are using a named pipe for communication, this setting must be set to PIPE, which appears after COM8:. Baud rate Selecting this option allows you to edit the speed your modem will operate at. This value can be anywhere from 110 to 57,600. More common values of the baud rate are 1200, 2400, 4800, and 9600, 19200, 14400, and 38400. Check your modem manual for the appropriate modem speed setting. Data Bits Selecting this option switches the data bits to 7 or 8. IBM PC systems use 8 bits to communicate. Using a 7 bits is required by older hardware and mainframes. If 8 bits are used, the Parity setting must be None. If 7 bits are used, the Parity setting can be None, Even, or Odd. Parity Selecting this option switches the parity to None, Even, or Odd. Parity is a form of error detection used by modems that communicate using 7 data bits. Since only 7 of a possible 8 data bits are used in a 7 bit communications session, the extra bit is used for error detection. There are three forms of this error protection LiveWire supports: None, Even, or Odd. Unfortunately, once an error has been detected, there is no way to correct it. Note that error means garbled text produced from static or other noise caused by the phone lines. Stopbits Selecting this option switches the number is stopbits to 1 or 2. Stopbits are extra bits at the end of each series of 8 bits that indicate the end of the series of bits. Most computer systems use 1 stop bit, although some require 2. Locked Port Selecting this option turns the locked port option off or on. If your modem has data compression you will want to turn this option on as well as telling your modem that you are using a locked port. Here is why: Most modems are "smart." When they connect to another computer theyreturn a message to LiveWire indicating the speed at which they connect. For example, a modem may return CONNECT 2400. When the dialer receives this message, LiveWire normally resets the communications parameters to communicate at 2400 bps. While this is fine for modems without error compression, modems with data compression are able to boost transmission speeds well beyond 2400 bps. For example, if your modem compresses a 2400 bps transfer by a factor of 2 then your actual transmission rate is twice that -- 4800 bps. Without a locked port LiveWire limits the connection to 2400 bps and no speed advantage is gained. Turning the Locked Port option ON prevents LiveWire from interpreting the modem's CONNECT 2400 message. Setting the Baud Rate option above to 4800 then allows greater throughput. You must also set an option on your modem to lock the port (although this may be the default). For information on how to do this, consult your modem manual. Named Pipe If you are attempting to connect to a named pipe server, you must set this field to the name of the pipe to connect to. All pipe names must begin with \PIPE\ and end in the remote computer name and remote pipe name. To use a named pipe the communications device must also be set to PIPE. ‚ïê‚ïê‚ïê 5.1.2. Modem Commands ‚ïê‚ïê‚ïê Modem Commands This selection leads you to a menu where you may change any of the options below. Modem Initialization Selecting this option allows you to change the modem initialization which is sent to the modem every time you start LiveWire. Here are some other options you can add to the end of the string that work with most hayes-compatible modems: E1 Set echo keystrokes on Q0 Quiet mode off M0 Modem speaker off V1 Verbose responses (such as CONNECT, BUSY) S7=60 Set dial timeout to 60 X3 1200 baud busy signal/no dial tone checking X4 2400 baud busy signal/no dial tone checking &C1 Return correct online/offline status There are many more commands the modem understands. The commands listed above are for 1200 and 2400 baud hayes compatible modems. Most modems are hayes compatible, or at least partially compatible. This manual cannot provide a complete list of modem commands since they do vary from modem to modem. If need be, review your modem's options in your modem manual. If you have a high speed or data compression modem make sure you read the manual to get the most out of your modem. It should have a list and description of all supported modem commands. Modem Dial Prefix Selecting this option allows you to change the dial command prefix. This is the command is required to initiate dialing of the phone. It is set to be ATDT by default, which means "ATtention, Dial Tone." If you have a pulse dial (rotary) phone, change this to ATDP, which stands for "ATtention, Dial Pulse." Modem Dial Postfix Selecting this option allows you to change the dial command postfix. Normally, this is just the ENTER key, which sends the command. The ENTER key is ^M for Control-M. Modem Hangup Command Selecting this option allows you to change the hangup command. The hangup command for hayes compatible modems is ^~^~^~+++~^~^~^ATH0^M, which translates to: ^~^~^~ Pause for 1.5 seconds (each ^~ is .5 seconds) +++ Puts the modem in command mode ^~^~^~ Pause for 1.5 seconds ATH0 Attention, hang up ^M ENTER key (to send modem command) NOTE: Before sending the modem hangup string LiveWire lowers the DTR signal. This will make many modems immediately hang up the phone. If this causes the modem to go off-hook, LiveWire does not send the hangup command. Connect message Selecting this option allows you to tell LiveWire what your modem responds with when it connects with another computer. Hayes modems return CONNECT. Hayes smart modems will return the speed of connection along with the CONNECT response. (EG: CONNECT 2400). LiveWire is smart enough to understand these responses. You can prevent LiveWire from interpreting the bps rate following the connect message by turning the locked port option on. Unable to connect #1,2,3,4 Selecting these options allows you to tell LiveWire what messages your modem may return if it is unable to reach the number you have dialed. Modem error message Selecting this option allows you to tell LiveWire what error message the modem sends if something has gone wrong. It is simply ERROR for Hayes compatible modems. ‚ïê‚ïê‚ïê 5.2. Terminal ‚ïê‚ïê‚ïê Terminal This menu contains configuration options related to terminal mode operation. Terminal Emulation Selecting emulation lets you change which terminal type LiveWire will emulate. The terminal type dictates how LiveWire will react to special control codes and how it will act under certain situations. TTY Selecting this option will make LiveWire emulate TTY or TeleTYpe emulation. TTY emulation is a plain vanilla emulation. It does nothing special, simply displays what it receives. ANSI Selecting this option will make LiveWire emulate the ANSI emulation. LiveWire's ANSI is a subset of the ANSI specification. Most bulletin boards and online services use the ANSI emulation. OS2You OS2You is a special emulation designed to work only with OS2You remote software. OS2You software, written by Mikael Wahlgren of Ridax programming, is a shareware program that allows you to run OS/2 programs remotely -- over the network, or over a modem. OS2You emulation is a modified ANSI emulation that has two special keys. Pressing ALT-- (alt-minus, hex keycode 8200) switches between local and remote keyboard. When local keyboard is on, LiveWire operates normally. When remote keyboard is on, all special keystrokes are sent to the remote program. This allows you to use function keys and ALTkeys remotely. In addition, pressing ALT-= (alt-equals, hex keycode 8300) causes the OS2You services menu to appear. 0+ Avatar Selecting this option will make LiveWire emulate the Avatar 0+ specification. This specification, used widely on bulletin boards, was created to increase the speed of ANSI text displays considerably. VT-102 Selecting this option will make LiveWire emulate the DEC VT-102 terminal. DEC VT-102 terminal emulation was coded from the DEC VT330 programmer's manual and has been tested against several UNIX and VMS systems as well as the public domain VTTEST program. Setup emulation... This option is only available if VT-102 is the current emulation. Thefollowing are settings for the VT-102 emulation. The default settings are those of a VT-102 terminal, so usually no configuration is required here. Backspace=DEL If Backspace=DEL is on then the backspace key always sends a DELETE character (0x7f) instead of the normal Backspace (0x8) character. This setting overrides the Off setting in the Defaults configuration menu. Destructive BS If Destructive BS is true, then backspace erases characters as it moves back one position. By default in VT-102 emulation backspaces are NOT destructive. Keypad Specifies current keypad mode. If the mode is numeric, the keypad sends actual numbers as the keys are pressed. If the mode is application, special escape sequences are sent to the remote computer. Cursor Keys Specifies the mode in which the cursor keys operate, application or normal. Cursor keys always send escape command sequences in VT-102. PFKeys Some programs which utilize VT-102 emulation require that four function keys (called PFKeys) be available. These keys can be mapped to one of three different local sets of keys, or they may be turned off. By default PFKeys are mapped to F1-F4, but can also be mapped to Shift F1-F4, Alt F1-F4, or CTRL F1-F4. Scroll end of line This option controls whether or not VT-102 automatically scrolls when its output reaches the last column (the rightmost edge) on the screen. Command pacing This option controls the pacing, in milliseconds, between each character when a VT-102 escape sequence is sent from LiveWire to the remote site. This happens when PF-keys are pressed or arrow keys are used. The command pacing option is set to zero by default, but some remote hosts cannot handle escape sequences that are sent quickly. In this case this value must be increased. Tab setup... Tab locations can be changed with this option. Pressing ENTER on this option will bring up a window showing the current tabstops. A tab stop is indicated by a "T". Tab stops can be toggled of and on by going to the position desired and pressing ENTER. In addition, pressing ALT-S will restore the standard VT-102 tabs. Pressing ALT-C will clear all tab stops. When you are done editing tabs, press ESC to exit tab setup. Answerback message This string is the answerback message sent by LiveWire in response to a ENQuiry character. By default this message is "LiveWire 2.2." Answerback This setting indicates whether LiveWire should respond to the ENQuiry and send the Answerback message. By default this is yes. Echo Keystrokes Selecting this option turns LiveWire's echo (display) of keystrokes on or off. In terminal mode, if you press a key, LiveWire normally does not display the key on the screen. It relies on either the modem or the system you are calling to do this. However, in some cases you may want LiveWire to echo the keys back to you. In such a case you would turn Echo Keystrokes to ON. Add linefeeds Selecting this option makes LiveWire either add linefeeds or not add line feeds to carriage returns. Normally, the modem or the other system you call will automatically drop down a line (linefeed) as well as carriage return (move the cursor to the beginning of the line). However, some systems only send carriage returns and expect LiveWire to add the linefeeds. In this case, Add linefeeds should be on. Backspace is DEL Turning on this option makes LiveWire send a DEL character when the BackSpace key is pressed. Many dial-in services use DEL as a backspace character. If your BackSpace key does not work, try turning this option on. Status Line Selecting this option turns the status line in the terminal on or off. The last line of your screen in terminal mode is normally used for status information. If the computer you are calling requires use of the whole screen, you should turn the status line off. VGA 50 line mode Selecting this option turns VGA 50 line mode on or off. If you have aVGA monitor, your monitor is capable of displaying 50 lines on your screen, as opposed to the normal 25. In this mode the dialing directory will display 30 entries per screen rather than 10. XON/XOFF flow control Selecting this option turns the XON/XOFF flow control protocol on or off. When XON/XOFF flow control is on, the receiving computer can send a command called XOFF to your computer that will stop transmission temporarily. When the receiving computer catches up, it sends an XON command, which resumes transmissions. This is used when the computer is receiving information too quickly to be processed. If flow control is on and your computer receives the XOFF command, your keyboard will not work until XON is received. If you wish to override this, press the ESC key. RTS/CTS flow control Selecting this option turns the RTS/CTS flow control protocol on or off. The RTS/CTS protocol serves the same purpose as the XON/XOFF flow control but is more effective and more widely used. Flow control is managed by the hardware at the UART level instead of sending commands. This option should remain on for most modems, especially if you have a high speed modem. Without RTS/CTS flow control you may loose large chunks of information while communicating at high speeds. Ignore carrier signal The carrier signal is a signal sent by the modem to the computer informing the computer that the modem still has a connection. If this signal is suddenly dropped, LiveWire realizes that no connection exists any more and stops its current operation. Turning this option on causes LiveWire to ignore the state of the carrier signal when uploading and downloading. This is useful if you have a direct connection or your modem does not properly report carrier. ‚ïê‚ïê‚ïê 5.3. Keys ‚ïê‚ïê‚ïê Keys This menu allows the setup of keyboard shortcuts (macros) and incoming/outgoing translation tables. Edit Macros... LiveWire's macros can be changed by selecting this option. LiveWire's macros control how the function keys operate. For example, when you press ALT-D, a macro is executed which makes the dialer screen appear. When you first select this option LiveWire will ask you to enter the macro filename. Press ENTER to retain the same macro filename. Macro char pacing This option determines the time, in milliseconds, to delay between sending each character in a macro. By default, this is zero. Press the function keys you wish to define or command below: Pressing any key or key combination here will allow you to define the macro associated with that key combination. You may define any key or key combination (except for normal typing or numeric keys). To do this, simply press that key or key combination. For example, Press F1. The macro for F1 will be displayed, and you may edit it if you like. When you are done editing the macro, press ENTER. NOTE: In VT-102 emulation PF keys and keypad keys cannot be redefined. List macros Pressing L from this menu will display a full list of all definable keys and the macros associated with them. Using the up and down arrow keys you can move the highlight bar through the list of macros. Press ENTER to edit the highlighted macro. Using Macros Macros have many uses. Anything you put in the macros will be sent to the modem when you press the key associated with that macro. For example, if you define F1 to be "Hello, I am using LiveWire Communications!" then when you press F1 it will be as if you typed "Hello, I am using LiveWire Communications!" To insert control characters into the macro, use a caret followed by the control key letter. For example, ^M. Some common control characters and what they correspond to are: ^M Carriage Return (as if you have pressed ENTER) ^G Makes a beep tone sound on the remote computer ^L Formfeed, which effectively clears the screen ^[ Escape character ^ Placing a single caret at the end of a line serves as a place marker for trailing spaces. The ending caret will not be transmitted There are also commands that can go in macros. Commands are contained in curly braces -- { }. The following macro commands are recognized by LiveWire: {BSISDEL} Toggles the action of the backspace key between the backspace and delete character {CAPTURE} Toggles capture of information on and off {CGA25} Switches to 25 line mode {CHANGE DIR} Invokes the change directory (directory tree) function {CHANGE DRIVE} Invokes the change drive function {CLRSCR} Clears the screen {CONFIG} Invokes the configuration menu {CONFIGEMU} Invokes the emulation configuration menu {DIALER} Invokes the dialer {DOORWAY} Toggles the doorway mode on and off {DOS} Invokes a OS/2 command shell {DOS:cmnd} Invokes a OS/2 shell where cmnd is executed {DUMP SCREEN} Dumps the screen to a file (like print-screen) {ECHO OFF} Turns local keyboard echo off {ECHO} Toggles local keyboard echo on or off {ECHO ON} Turns local keyboard echo on {EGA43} Switches to 43 line mode {EXIT} Exits LiveWire (asks the user before exiting) {HANG-UP} Sends the command to hang up the modem {HELPSCREEN} Brings up the help/command screen {KEYCONFIG} Invokes macro configuration {LEARN SCRIPT} Turns script learning on or off {LINEFEEDS} Toggles local linefeeds on or off {LINEFEEDS ON} Turns linefeeds on {LINEFEEDS OFF} Turns linefeeds off {LINES} Toggles between CGA 25 line and EGA 43 line screen mode {LOG} Toggles the log on and off {MACROCONFIG} Invokes macro configuration {PASSWORD} Sends your password (as listed in the dialer) to the remote computer {PRINTER} Toggles capture to printer on and off {PORTCONFIG} Invokes the communications port configuration {RECEIVE FILES} Invokes a download session {RUN SCRIPT <filename>} Invokes a script. If no filename is specified it is requested from the user. If a filename is specified the script is immediately executed. {SCROLL-BACK} Invokes scroll-back viewer {SCROLL-BAK} Toggles scroll back on and off {SEND FILES} Invokes an upload session {SEND ANSI} Invokes the menu to send an ANSI color command to the remote computer {SEND BREAK} Sends a BREAK signal to the remote computer {STATUS} Toggles the status line on and off {VIEW FILE} Invokes the file editor {XFLOW OFF} Turns Xon/Xoff flow control off {XFLOW} Toggles Xon/Xoff flow control on or off {XFLOW ON} Turns Xon/Xoff flow control on {XLATETABLES} Invokes translate tables configuration You may mix commands and text. For example, a macro can be defined as: Running Configuration{CONFIG}Done. Any of these commands can be embedded in a macro. These commands are dynamically linked with the command menu. If you move the clear screen command ({CLRSCR}) from ALT-C to F1, the change will be reflected in the command screen automatically. Input translate table... Selecting this option will allow you to configure the translation table. The input translate table controls all information going and coming over themodem. Before it is displayed on your screen, it is passed through the translate table. For example, using the translate table you can change all A's to Z's or change all Z's to A's. The translate table lists numbers 0 through 255. Each number corresponds with a letter or character. For example, the number 65 corresponds with the letter A. Using this information, you can modify the translate table so that when the letter A is received it is changed to another letter. Note that the input translate table has no effect on special terminal emulation codes. Swap Pressing S, for swap, allows you to view numbers 129 to 255 of the translate table, since the screen can only display 128 values at a time. Change Pressing C, for change, allows you to modify the translate table. You will be asked which number you want to change. For example, you would type in 65 and press ENTER for the letter A. It then asks you for the new value, any number from 0 to 255. View Pressing V, for view, allows you to view the letters and characters associated with the numbers. Pressing V again will return to the numeric mode. Output translate table... Selecting this option will allow you to configure the translation table. The output translate table controls all information going over the modem. Before it is displayed on your screen, it is passed through the translate table. For example, using the translate table you can change all A's to Z's or change all Z's to all A's. The translate table lists numbers 0 through 255. Each number corresponds with a letter or character. For example, the number 65 corresponds with the letter A. Using this information, you can modify the translate table so that when the letter A is sent it is changed to another letter before being sent over the modem. See Input translate table for information on swap, change, and view commands. ‚ïê‚ïê‚ïê 5.4. Protocols ‚ïê‚ïê‚ïê Protocols File transfer protocols may be configured using this menu. Zmodem-32 Batch Zmodem setup options can be configured by selecting this option. Auto-download Toggles Zmodem auto-download on or off. When Zmodem autodownload is on, Zmodem will automatically initiate a download when a packet header is seen. 32-bit CRC Toggles Zmodem 32-bit CRC checking on or off. When Zmodem 32-bit CRC is off, Zmodem uses 16-bit CRC checking. Rename files if FAT Toggles long filename renaming on FAT file systems on or off. If this option is off and a file with a long HPFS-style filename is downloaded to a FAT drive, the download will fail. If this option is on, a file with a long HPFS-style filename will be translated to the 8.3 FAT standard. Note that this translation is only done if the destination drive is FAT. Rename duplicate files Toggles whether or not the file being received will be renamed if the filename already exists. LiveWire will first attempt to determine if the file transfer should be resumed by checking the file size. If the file on the disk compared to the file being received is smaller, LiveWire will attempt a resume the file transfer. If the file transfer cannot be resumed, the file is renamed. Rename format This field specifies how incoming files will be renamed. By default the file's extension is removed and replaced with a unique number, starting with 1. If another format is required, this field can be modified to match that format. Any normal keys typed into this field at the keyboard will be added to the file. In addition, there are embedded codes which begin with a percent sign (%): %f Name of file being received, excluding extension %e Extension of file being received %w Whole name (name and extension) of file being received %n A unique sequential number, assigned by LiveWire %% Translates into a single percent sign Some examples of how this field might be used are: %f.%n Translates filename "LW22.ZIP" into ("LW22.1" or "LW22.2" or "LW22.3", etc.) %w;%n Translates filename "LW22.ZIP" into "LW22.ZIP;1" Renamed file #%n %w Translates filename "LW22.ZIP" into "Renamed file #1 LW22.ZIP" Resume uploads Toggles whether or not Zmodem sends a resume request at the beginning of each upload. The receiver is responsible for determining whether or not the file should be resumed, and acts accordingly. NOTE: Leaving this option on will NOT cause problems uploading non-resumed files. Resume downloads Sets whether or not Zmodem attempts to resume a download. If this option is set to "off," Zmodem will never attempt to resume a download. If this option is set to "on," Zmodem will always attempt to resume transfer an existing file if the existing file is smaller than the file being received. If this option is set to "ask," LiveWire will ask before resuming any file. Ascii Ascii setup options can be configured by selecting this option. Character pacing Sets the delay between characters, in milliseconds. Line pacing Sets the delay after a CR or LF, in milliseconds. Strip LF Toggles linefeed stripping on or off. Strip CR Toggles carriage return stripping on or off. CR -> CR/LF Toggles carriage return conversion to carriage return followed by linefeed on or off. LF -> CR/LF Toggles linefeed conversion to carriage return followed by linefeed on oroff. Expand blank lines If this option is on, empty lines are expanded so as to contain a single space. This is to avoid an empty line condition, which stops some editors. Edit external protocols Selecting one of the protocols in the list will allow you to change the information for that protocol. To add a new protocol you must select the empty entry after the last protocol and provide the following information: Name Selecting this option allows you to change the name of the protocol. All protocols must be named. Hotkey Selecting this option allows you to change the unique hotkey associated with the protocol. The hotkey is the character that may be pressed to automatically jump the highlight bar to that protocol. The hotkey should be one of the letters in the name of the protocol. This hotkey is also used to specify the protocol in the dialing directory and the script language. Prompt filename Selecting this option changes whether LiveWire will prompt the user for a filename before downloads. If the protocol you are adding requires that LiveWire ask for the filename before receiving (downloading) a file, this option should be yes. Protocols such as Zmodem obtain the download filename from the sending computer automatically. Therefore, Zmodem does not require that the user enter a filename when receiving a file. Receive command 1 and 2 Selecting this option will allow you to change the OS/2 commands required to run the protocol to receive a file. Read the external protocol manual for information about what command to use. Some protocols may require more than one DOS command, so two lines are provided. Most external protocols will require that you send the communications port, modem speed, and filename. If you put %0 in the command line, it will be replaced with the port number. %1 will be replaced with the modem speed. %2 will be replaced with the filename or path. %3 is replaced with the file handle of the currently opened device. Example: DSZ port %0 speed %1 rz %2 May expand to: DSZ port 1 speed 2400 rz C:\TMPZIP This replacement is done automatically by LiveWire, all you need to do is put the percent commands in the correct place. Send command 1 and 2 Selecting this option will allow you to change the OS/2 commands required to run the protocol to send a file. Read the external protocol manual for information about what command to use. Some protocols may require more than one DOS command, so two lines are provided. Most external protocols will require that you send the communications port, modem speed, and filename. If you put %0 in the command line, it will be replaced with the port number. %1 will be replaced with the modem speed. %2 will be replaced with the filename or path. Example: DSZ port %0 speed %1 rz %2 May expand to: DSZ port 1 speed 2400 sz C:\TMPZIP\READ.ME This replacement is done automatically by LiveWire, all you need to do is put the percent commands in the correct place. ‚ïê‚ïê‚ïê 5.5. Dialer ‚ïê‚ïê‚ïê Dialer Dialer on startup Turning this option on causes LiveWire to automatically enter the dialing directory when it starts up. By default this option is off and LiveWire enters terminal mode. This setting is turned off if a script is run from the command line. Music on connect Turning this option off stops LiveWire from making sound. Popup on connect Turning this option on causes LiveWire's dialer to interrupt your current program by switching momentarily to full screen mode when a connection has been established. Connect timeout Selecting this option allows you to change the time LiveWire will spend waiting to be connected to each computer system you dial. By default the connect timeout is set to 45 seconds. Most computers will establish connection within 15 to 20 seconds. Redial wait Selecting this option allows you to change how long LiveWire will wait between phone dialing attempts. By default it is set to five seconds. In other words, if LiveWire gets a busy signal it will wait five seconds before trying again. inter-character Pacing Most modems and network setups require a minuscule pause between characters sent to the modem. This option is the number of milliseconds LiveWire should pause between each character it sends to the modem. By default this option is set to 5 milliseconds. ‚ïê‚ïê‚ïê 5.6. Scroll-back ‚ïê‚ïê‚ïê Scroll-back Scroll-back Selecting this option turns the scroll-back buffer on or off. By default scroll-back is on. This means that LiveWire stores all text that scrolls off the screen for review. scroll-back Quote When quoting a portion of the text from your scroll back buffer, sometimes a character or characters to precede each line of quoted text. These characters indicate to the reader that the text he is reading has been quoted from another source. By default this option is a single caret (>). quote character Pacing This option sets the pacing (in milliseconds) between characters when quoting text from scroll-back. Some systems will require a pacing in order to keep up with the incoming information. By default, this value is zero. ‚ïê‚ïê‚ïê 5.7. Colors ‚ïê‚ïê‚ïê Colors Under this configuration menu LiveWire's color scheme can be configured. Color schemes... This sub-menu contains four pre-defined color schemes to choose from Cool cyan This option selects a cyan (light blue) color scheme. Moronic Monochrome This option selects a monochrome (black and white) color scheme. Big Blue This option selects the traditional blue-on-grey color scheme. Looks great in a corporate office. Neat-o Neon This option selects a wild neon-like color scheme. To do change a specific color select one of the options below. A color selection box will appear. In the color selection box the up and down arrow keys change the background color and the right and left arrow keys to change the foreground color. A sample of the color you've selected will appear. Press ENTER to select the color. Terminal Selecting this option allows you to change the color in the terminal. Terminal Message Selecting this option allows you to change the color of the messages displayed while in the terminal. Menu text Selecting this option allows you to change the color of the normal menu text. Menu Secondary text Selecting this option allows you to change the color of the secondary text in the menus. Menu window Border Selecting this option allows you to change the color of the menu's border. Menu Highlights Selecting this option allows you to change the color of the background highlights (scroll bars, for example) in the menus. Status liNe Selecting this option allows you to change the color of the status line at the bottom of the screen. ‚ïê‚ïê‚ïê 5.8. Paths ‚ïê‚ïê‚ïê Paths Under the file configuration menu you can set up file paths and names. Editor This field specifies the editor that LiveWire uses to view and edit files. By default LiveWire uses OS/2's system editor, E. Script path This field specifies the default directory where scripts can be found. Upload path This field specifies the default directory from which uploads (files to be sent) can be found. Normally this option is blank, allowing the user to enter a path at the time of the upload. Download path This field specifies the default directory where downloads are sent. Normally this option is blank, allowing the user to enter the path on each download. Protocols that do not prompt you for a download file name (such as Zmodem) will automatically use the download directory specified in this field. If this field is empty the default directory is used. Usage Log This field contains the path and filename of LiveWire's usage log file. If this is left empty, LiveWire will ask for a log file name when the usage log is turned on. Capture file This field contains the default path and filename for the capture file. Scroll back save This field contains the default path and filename for scroll back save. Screen Dump This field contains the default path and filename for a screen dump. A screen dump is saving the contents of the current screen to a file. This is like print screen to a file. ‚ïê‚ïê‚ïê 5.9. Exit ‚ïê‚ïê‚ïê Exit Save Configuration Select this option to save the changes in the configuration. Exit without saving Select this option to cancel the changes made to the configuration. Changes made to the macros and transfer protocols cannot be canceled and will be in effect even if you select abort configuration. ‚ïê‚ïê‚ïê 6. The Terminal Mode ‚ïê‚ïê‚ïê The Terminal Mode The modem initialization string When LiveWire first starts up it sends the modem initialization string. The modem initialization string is a set of commands sent to the modem that set it up for use by LiveWire Communications. Before sending the initialization string, however, LiveWire checks to see if the modem is connected to another computer. If so, LiveWire will tell you that you are online and will ask if you still want to send the initialization string. Some modems will initially report that they are connected with another computer, but after sending the first initialization will report the correct status. In some occasions, the Hayes Personal Modem for example, the modem ALWAYS reports that it is connected to another computer. In this case LiveWire will always ask if you want to send the initialization string. You should answer Yes. If your modem was not listed as one of the pre-defined modems in the LiveWire modem database you should consult your modem manual for the correct settings. Some of the most common problems that occur if the modem initialization string is wrong are: Modem says "ERROR" (although the modem may still work correctly) Modem does not respond to commands Modem does not echo back keystrokes Modem responds with numbers instead of commands like OK, CONNECT, and BUSY Modem always indicates that is online Modem connects at the wrong speed LiveWire's dialer cannot dial LiveWire's dialer cannot recognize busy or connect signals LiveWire's dialer never gets a busy signal, but will connect LiveWire's dialer won't automatically detect the other modem's speed Explanation of the status line The last line on the screen is reserved for status information and help. In the terminal mode the status line looks like: | LW | COM1 2400 N81 | Offline | 8:19:24P | L P C E X F R B | ANSI | COM1 The communications device (COM1-8 or PIPE) 2400 The modem speed N Parity: None, Even, or Odd 8 The data bits: 7 or 8 1 The stop bits: 1 or 2 Offline Indicates if the modem is offline or online. If the modem is online, this will show the time spent online. 8:19:24P The current time L Indicates LiveWire is keeping a log P Indicates LiveWire is capturing to the printer C Indicates LiveWire is capturing to a file E Indicates LiveWire is echoing local keystrokes X Indicates that XON/XOFF flow control is on F Indicates that linefeeds are on R Indicates that RTS/CTS flow control is on ANSI Indicates the current terminal emulation In all other modes, such as the dialer, the status line contains limited help and available commands. Terminal mode: a direct link to your modem The terminal mode serves as a direct link to your modem. Anything you type in terminal mode is sent to the modem. The modem has two modes: command mode and data mode. Initially, the modem is in command mode. While in command mode it will accept what's called Hayes AT commands. AT is short for "ATtention." Typing AT and then pressing ENTER should make the modem respond by printing OK on the screen. Some other commands are ATH for hangup and ATA for answer phone. In this command mode the modem interprets anything you type as a command. When the modem connects to another computer it automatically changes into data mode. In data mode the modem ignores all commands and opens a link between your computer and the other computer. Anything you type will be sent to the other computer. Once in data mode, there is a way to switch out of it -- type three +'s with a 1/2 second delay between each +. At this point, the modem will switch out of data mode and allow you to give it commands. It's unlikely you'll need to do this, because if either computer hangs up the phone the modem will return to command mode automatically. ‚ïê‚ïê‚ïê 7. The Command Screen ‚ïê‚ïê‚ïê The Command Screen LiveWire[Home] Procomm+[Alt-Z] Qmodem[Home] Telix[Alt-Z] Boyan[Ctrl-Home] Using the command screen When LiveWire first loads up it will display the following line: Press <key> for menu command screen Pressing the key shown will bring up the command screen. The command screen provides a list to the major commands supported by LiveWire and the key combination which activates it. The command screen is important because the key combination associated with each command can change according to the macros setup. While in the command screen, pressing any of the listed key combinations will activate that command. Pressing the Escape key will return you to the terminal mode. You may also select the command you want by moving the highlight bar with the arrow keys, and then pressing ENTER when the highlight bar is on the command desired. Dynamic command keys and changing keysets All of LiveWire's command keys are dynamic. That is, you can configure the macros such that any key combination can bring up a desired function. For your convenience, LiveWire includes keyset emulations for LiveWire, Procomm+, Qmodem, Telix, and Boyan. This will help you adapt to LiveWire when switching from another communications program. All of the commands mentioned in this manual will, in fine print, list the keys for all of these keysets which activate the command. Changing the keyset emulations after the initial configuration of LiveWire is accomplished by bringing up the command screen and pressing K for keyset. Then press L for the LiveWire keyset, P for the Procomm keyset, Q for the Qmodem keyset, T for the Telix keyset or B for the Boyan keyset. NOTE: changing the keyset clears the macros. If you have defined some macros for your personal use they will be erased by this command. You can also change the keys which activate any of the commands on the command menu right from the command menu. To do this, move the highlight bar to the command youwish to change and press N to select a new key combination. Then, press the key combination you wish to associate with the highlighted command. As long as that key combination is not used for another command the change will take place immediately and permanently on the command screen and in the LiveWire configuration. ‚ïê‚ïê‚ïê 7.1. Phone book ‚ïê‚ïê‚ïê Phone book LiveWire [Alt-D] Procomm+[Alt-D] Qmodem [Alt-D] Telix [Alt-D] Boyan [Alt-D] The phone book allows you to keep phone numbers of bulletin boards and online services. Directly from the phone book you can dial simply by moving the highlight bar to the number and pressing ENTER. The dialer is able to read and modify Qmodem 4.x and 5.0, Procomm+, Telix, and Boyan phone files. Of course, LiveWire has it's own proprietary dialing directory format too. LiveWire has two proprietary dialing directory formats, 2.0 style and 2.1 style. Version 2.1 style allows much longer phone numbers and names and includes a comments section. Version 2.0 style retains compatability with the old DOS version of LiveWire. Note that DOS versions of LiveWire can only read 2.0 style phone books. The dialer also has excellent editing and sorting functions. For more information see the section The Phone Book. ‚ïê‚ïê‚ïê 7.2. Clear screen ‚ïê‚ïê‚ïê Clear screen LiveWire[Alt-C] Procomm+[Alt-C] Qmodem[Alt-C] Telix[Alt-C] Boyan[Alt-Z] This command simply clears the terminal mode screen. ‚ïê‚ïê‚ïê 7.3. Scroll back ‚ïê‚ïê‚ïê Scroll back LiveWire[UP-Arrow] Procomm+[Alt-F6] Qmodem[UP-Arrow] Telix[Alt-B] Boyan[Up-Arrow] Using the scroll-back command you may review what has scrolled off your screen during your connection. You may then save all or parts of this scroll-back buffer. To review scroll-back you can press the up and down arrow keys. Doing this moves the white highlight bar up and down the screen. When the highlight bar reaches the top or bottom of the screen the screen will scroll automatically to reveal more of the session. Clearing the buffer You can clear the scroll-back buffer by pressing C when it is activated. Saving the buffer Pressing S will allow you to save the scroll-back. You will be asked for a filename to save the scroll-back to. If you wish to save only part of the scrollback you can block highlight the part you want to save before pressing S. Marking a block of text for saving To preform block highlighting, move the highlight bar to the first line you wish to highlight. Press B, for Begin Block. Now move the highlight bar to the last line you wish to highlight. Press E, for End Block. Both the beginning line, ending line, and all lines in between will be highlighted. To save this highlighted block, press S. Quoting text from the buffer You can also quote a highlighted block. Quoting means that the highlighted block is transmitted over the modem, as if you typed it in yourself. One example of where this feature can be used is if you are replying to a message. If you wish to include some of the original message in your reply for reference purposes you can highlight just the lines you want from the original message and then have LiveWire retype it for you. To preform a quote, highlight the block you wish to quote and then press Q, for Quote. Searching for text in the buffer LiveWire also allows you to search for strings within the scroll-back. This is extremely useful for finding the desired position in a very long scroll backsession. To start searching, press F for find and type in a string to search for. LiveWire will search backwards, from the current highlight bar position to the top of the scroll-back buffer. When LiveWire finds the string it will move the highlight bar to the line in which the string was found and stop searching. If you wish to search for another occurrence of the string press A, for search again. Exiting the buffer When you are finished looking through the scroll-back you may exit back to terminal mode by pressing ESC. ‚ïê‚ïê‚ïê 7.4. Capture ‚ïê‚ïê‚ïê Capture LiveWire[Alt-K] Procomm+[Alt-R] Qmodem[Ctrl-Home] Telix[Alt-L] Boyan[Alt-L] This command will capture the whole communications session to a file. The capture can be turned off by repeating this command again. ‚ïê‚ïê‚ïê 7.5. Dump screen ‚ïê‚ïê‚ïê Dump screen LiveWire[Alt-U] Procomm+[Alt-G] Qmodem[Alt-T] Telix[Alt-I] Boyan[Alt-S] This command allows you to save the current terminal mode screen to a disk file. ‚ïê‚ïê‚ïê 7.6. ANSI color ‚ïê‚ïê‚ïê ANSI color LiveWire[Alt-A] Procomm+[Alt-N] Qmodem[Alt-7] Telix[Alt-N] Boyan[Alt-O] This command sends the correct ANSI codes over the modem to change to any desired color. This may be useful in messages and while chatting. ‚ïê‚ïê‚ïê 7.7. Hang-up ‚ïê‚ïê‚ïê Hang-up LiveWire[Alt-H] Procomm+[Alt-H] Qmodem[Alt-H] Telix[Alt-H] Boyan[Alt-H] This command attempts to hang up the modem. It attempts two methods. First, it lowers the DTR (Data Terminal Ready) signal for a 1/4 second and raises it. Most modems will take this as a signal to hangup. If the modem fails to hangup using this method LiveWire sends a the hangup string to the modem instructing it to hang up the phone. ‚ïê‚ïê‚ïê 7.8. Exit ‚ïê‚ïê‚ïê Exit LiveWire[Alt-X] Procomm+[Alt-X] Qmodem[Alt-X] Telix[Alt-X] Boyan[Alt-X] This command exits LiveWire Communications. Before exiting, LiveWire will ask you if you're sure you want to exit. Press Y (or ENTER) to exit or N to return to LiveWire. ‚ïê‚ïê‚ïê 7.9. Configuration program ‚ïê‚ïê‚ïê Configuration LiveWire[Alt-N] Procomm+[Alt-S] Qmodem[Alt-N] Telix[Alt-O] Boyan[Alt-C] This command allows you change the configuration for LiveWire. Configuration is explained in the section Configuration. ‚ïê‚ïê‚ïê 7.10. Port setup ‚ïê‚ïê‚ïê Port setup LiveWire[Alt-P] Procomm+[Alt-P] Qmodem[Alt-P] Telix[Alt-P] Boyan[Alt-P] This command allows you to change the serial port configuration. This includes COM port, baud rate, data bits, stop bits, parity, network, and port setup. This is discussed in the section Configuration options and explanations. ‚ïê‚ïê‚ïê 7.11. Macros ‚ïê‚ïê‚ïê Macros LiveWire[Alt-M] Procomm+[Alt-M] Qmodem[Alt-J] Telix[Alt-K] Boyan[Alt-M] This command allows you to configure the keyboard macro definitions. This is discussed in the section Configuration options and explanations. ‚ïê‚ïê‚ïê 7.12. X-late Tables ‚ïê‚ïê‚ïê X-late Tables LiveWire[Alt-T] Procomm+[Alt-W] Qmodem[Alt-A] Telix[Alt-W] Boyan[Alt-T] This command allows you to change the translate tables LiveWire uses. This is discussed in the section Configuration options and explanations. ‚ïê‚ïê‚ïê 7.13. Config keys ‚ïê‚ïê‚ïê Config keys LiveWire[Alt-Y] Procomm+[Alt-F8] Qmodem[Alt-6] Telix[Alt-2] Boyan[Alt-K] This command allows you to configure the keyboard macros or translate tables. This is discussed in the section Configuration options and explanations. ‚ïê‚ïê‚ïê 7.14. Set Emulation ‚ïê‚ïê‚ïê Emulation LiveWire[Alt-E] Procomm+[Alt-U] Qmodem[Alt-G] Telix[Alt-T] Boyan[Alt-A] Sets the terminal emulation LiveWire uses. Currently, LiveWire supports TTY, ANSI, OS2You, and VT-100. Most bulletin boards and online services require or recommend ANSI emulation. For more information, see Terminal Emulations. ‚ïê‚ïê‚ïê 7.15. Run script ‚ïê‚ïê‚ïê Run script LiveWire[Alt-I] Procomm+[Alt-F5] Qmodem[Alt-F] Telix[Alt-G] Boyan[Alt-R] This command starts a LiveWire script file. You will be asked for the filename of the script (including extension). You will then be asked for script parameters. If you do not know what script parameters to provide, just press ENTER. ‚ïê‚ïê‚ïê 7.16. Learn script ‚ïê‚ïê‚ïê Learn script LiveWire[Alt-L] Procomm+[Alt-F10] Qmodem[Alt-Q] Telix[Alt-Y] Boyan[Alt-8] This function attempts to learn your keystrokes and records your keystrokes in a script file for later playback. This feature is useful for automating redundant tasks such as typing your name and password to login to a system. For more information about script learning see Using Script Learn. ‚ïê‚ïê‚ïê 7.17. Send files ‚ïê‚ïê‚ïê Send files LiveWire[PgUp] Procomm+[PgUp] Qmodem[PgUp] Telix[Alt-S] Boyan[PgUp] This command lets you send files over the modem using any of the listed protocols. A discussion of how to send and receive files is found in the section Transferring files. ‚ïê‚ïê‚ïê 7.18. Receive files ‚ïê‚ïê‚ïê Receive files LiveWire[PgDn] Procomm+[PgDn] Qmodem[PgDn] Telix[Alt-R] Boyan[PgDn] This command lets you receive files over the modem using any of the listed protocols. A discussion of how to send and receive files is found in the section Transferring files. ‚ïê‚ïê‚ïê 7.19. OS/2 shell ‚ïê‚ïê‚ïê OS/2 shell LiveWire[Alt-S] Procomm+[Alt-F4] Qmodem[Alt-R] Telix[Alt-J] Boyan[Alt-J] This command temporarily shells you to an OS/2 command prompt. To return to LiveWire simply type EXIT and then press Enter at the DOS prompt. ‚ïê‚ïê‚ïê 7.20. Change drive ‚ïê‚ïê‚ïê Change drive LiveWire[Alt-G] Procomm+[Alt-F9] Qmodem[Alt-L] Telix[Alt-3] Boyan[Alt-7] This command allows you to change the logged drive. Simply move the highlight bar to the drive you want and press ENTER. You may also type the letter of the drive to change to, A through Z. ‚ïê‚ïê‚ïê 7.21. Change dir ‚ïê‚ïê‚ïê Change dir LiveWire[Alt-O] Procomm+[Alt-F7] Qmodem[Alt-O] Telix[Alt-4] Boyan[Alt-N] This command allows you to change the default directory by choosing it from the file navigator. The first time this command is run LiveWire will scan the disk to make the directory structure. This may take some time. ‚ïê‚ïê‚ïê 7.22. Directory ‚ïê‚ïê‚ïê Directory LiveWire[Alt-R] Procomm+[Alt-F] Qmodem[Alt-W] Telix[Alt-1] Boyan[Alt-0] This command displays a listing of the files in the current directory by the OS/2 DIR /P command. ‚ïê‚ïê‚ïê 7.23. View file ‚ïê‚ïê‚ïê View file LiveWire[Alt-V] Procomm+[Alt-V] Qmodem[Alt-V] Telix[Alt-A] Boyan[Alt-V] This command invokes the external editor to edit a file of your choice. By default the OS/2 system editor E is invoked on the file. ‚ïê‚ïê‚ïê 7.24. Send BREAK ‚ïê‚ïê‚ïê Send BREAK (NOT listed in command menu) LiveWire[Alt-B] Procomm+[Alt-B] Qmodem[Ctrl-End] Telix[Ctrl-End] Boyan[Ctrl-End] This command will send a 1.5 second break signal to the remote computer. ‚ïê‚ïê‚ïê 7.25. Log ‚ïê‚ïê‚ïê Log LiveWire[Alt-1] Procomm+[Alt-F1] Qmodem[Alt-0] Telix[Alt-U] Boyan[Alt-U] This turns the usage log on and off. LiveWire logs such things as time of connection to another computer, files transferred, functions executed, time online, when carrier was dropped, and when LiveWire was started and exited. ‚ïê‚ïê‚ïê 7.26. Printer ‚ïê‚ïê‚ïê Printer LiveWire[Alt-2] Procomm+[Alt-L] Qmodem[Alt-9] Telix[Ctrl-@] Boyan[Ctrl-PrtSc] This command turns the printer on or off. If on, anything appearing in the terminal mode is sent to the printer. It is like the capture command which saves the session, except to the printer. ‚ïê‚ïê‚ïê 7.27. Echo ‚ïê‚ïê‚ïê Echo LiveWire[Alt-3] Procomm+[Alt-E] Qmodem[Alt-E] Telix[Alt-E] Boyan[Alt-E] This command turns echo on or off. If echo is on, LiveWire displays every key that you type in the terminal mode on the screen as you type it. This is not always desirable because normally the modem and other computers do that for you automatically. If you see doubled characters on your screen you should turn echo off. ‚ïê‚ïê‚ïê 7.28. Scroll-back ‚ïê‚ïê‚ïê Scroll-back LiveWire[Alt-4] Procomm+[Alt-1] Qmodem[Alt-U] Telix[Alt-5] Boyan[Alt-2] This command turns the scroll-back on or off. Scroll-back is designed to use as little memory as possible, but if you plan to run LiveWire for a long time without exiting it is best to turn Scroll-back off to conserve memory. ‚ïê‚ïê‚ïê 7.29. Xon/Xoff ‚ïê‚ïê‚ïê Xon/Xoff LiveWire[Alt-5] Procomm+[Alt-2] Qmodem[Alt-Z] Telix[Alt-6] Boyan[Alt-3] This command turns XON/XOFF flow control on or off. If flow control is on, the computer you are talking to will be able to temporarily pause your transmission in order to catch up. This is rarely used, but can be useful. It can be a nuisance, too. Sometimes line noise or static upon hanging up will cause a burst of characters, one of which will be the code to stop transmission. This will lock your keyboard until you press ESC to override the command. ‚ïê‚ïê‚ïê 7.30. Doorway ‚ïê‚ïê‚ïê Doorway LiveWire[Alt-6] Procomm+[Alt-3] Qmodem[Alt-=] Telix[Alt-=] Boyan[Alt-4] This command turns the special doorway mode on or off. While in doorway mode, you will be able to send function and arrow keys over the modem. Normally, only printing characters (letters, numbers, and symbols) can be sent over the modem. Using the special doorway mode all other keys will be sent over the modem. The use of this mode requires that the other computer be able to recognize the codes for the function keys. Some message editors and remote DOS shells recognize the keys. The program that initiated this standard is DOORWAY. The shareware DOORWAY program, by Marshall Dudley, allows any text based program to be run on one computer and appear on another via a modem. ‚ïê‚ïê‚ïê 7.31. Status Line ‚ïê‚ïê‚ïê Status Line LiveWire[Alt-7] Procomm+[Alt-4] Qmodem[Alt--] Telix[Alt-7] Boyan[Alt-5] This command turns the terminal mode status line on or off. In some cases where the whole screen is needed, the status line, which takes resides on the last screen line, may not be desirable. ‚ïê‚ïê‚ïê 7.32. Linefeeds ‚ïê‚ïê‚ïê Linefeeds LiveWire[Alt-8] Procomm+[Alt-F3] Qmodem[Shift-Tab] Telix[Shift-Tab] Boyan[Shift-Tab] This command turns linefeeds on or off. If linefeeds are on, LiveWire adds a linefeed to every carriage return. IE: It'll automatically drop down a line when the cursor moves to the beginning of the line. ‚ïê‚ïê‚ïê 7.33. 50 lines ‚ïê‚ïê‚ïê 50 lines LiveWire[Alt-9] Procomm+[Alt-6] Qmodem[Alt-4] Telix[Alt-9] Boyan[Alt-G] This command toggles between 25 lines per screen and 50 lines per screen mode. ‚ïê‚ïê‚ïê 7.34. Backspace=DEL ‚ïê‚ïê‚ïê Backspace=DEL LiveWire[Alt-0] Procomm+[Alt-0] Qmodem[Alt-1] Telix[Alt-0] Boyan[Alt-9] This toggles the BackSpace key between sending a BS (backspace) character and sending a DEL character. For most BBSs a backspace (the default) is required. Some systems (UNIX or VMS, in particular) may require a DEL character, though. If your backspace key appears not to work, use this command to toggle your backspace setting. ‚ïê‚ïê‚ïê 8. The Phone Book ‚ïê‚ïê‚ïê The Phone Book LiveWire [Alt-D] Procomm+[Alt-D] Qmodem [Alt-D] Telix [Alt-D] Boyan [Alt-D] The jobs the phone book performs The dialer keeps a list of up to 200 phone numbers of other computers. The dialer keeps records such as computer name, number, last called, and number of times called. The dialer also preforms useful functions such as dialing the modem and establishing a connection to one of the services in the phone book. You can have the phone book redial a number or several selected numbers until it connects with another computer. Upon connection to another computer the dialer will return to terminal mode so you can communicate with the other computer. ‚ïê‚ïê‚ïê 8.1. Entering a phone number ‚ïê‚ïê‚ïê Entering a phone number The basic thing you'll need to know to use the dialer is how to enter a new phone number into the list. You can do this by using the edit command in the dialer. First, bring up the dialer by pressing the key combination Alt-D from the terminal mode. Now, using the up and down arrow keys, move the highlight bar to a blank entry in the phone book. Now press the "E" key, for Edit. A window appears displaying information for the entry you've selected. The highlight bar appears at the top of the window over the "Name" field. Press ENTER to edit the name of the computer system to be added. Type in the name and press ENTER. Now press the down arrow key once, moving the highlight bar to the "Number" field. Press ENTER to edit the phone number. Type in the phone number and then press ENTER when you're finished. When entering the phone number the following keys have special meanings: , A comma will pause the phone for 1/2 a second. This is useful when the modem must wait for before continuing to dial, as some long distance phone companies and foreign calls require. A - J The letters A through J are called dial codes. Putting a dial code in the phone number will cause LiveWire to expand that dial code into a code you specify. For example, if you type in as a phone number: A555-3218 LiveWire will look up the dial code A. If it is defined by you, it will be replaced. For example, in this instance if A is defined as "9,," then the number would expand to 9,,555-3218. As you might imagine, this could be useful when you switch between a phone line that requires that you dial 9 before dialing and one that does not. The dial codes can be defined through the edit (D)ialing codes command, "D" from the dialing menu. When you are finished entering this information you might also want to edit other information such as speed, parity, bits, stop bits, script, password, last call, total calls, protocol, emulation, and echo. ‚ïê‚ïê‚ïê 8.2. Loading another programs dialing directory ‚ïê‚ïê‚ïê Loading another programs dialing directory LiveWire provides a unique feature in that it allows you to directly load several other dialing directory formats. LiveWire supports LiveWire, Qmodem 4.x and 5.0, Telix, Boyan, Procomm 3.4.2, and Procomm+ phone directory types. To load one of these phone files, first enter the dialing directory (press Alt-D from the terminal mode). Now press the "L" key to Load a new phone directory. When you are prompted, type the path and name for the dialing directory you wish to load, then press ENTER. Loading a Telix directory requires one extra step. Since Telix phone files are of variable length, they must be converted to LiveWire format before it can be used. So, when you try to load a Telix phone directory LiveWire will prompt you to enter a name for the converted Telix file. Another problem with Telix phone files is that they are cut off after 200 entries. This is due to the fact that the LiveWire phone directory format does not support more than 200 entries. For all phone directories except Telix, the file is not automatically converted to LiveWire format. If you wish to convert the phone directory to LiveWire format (although it is not necessary), press the "N" to coNvert to LiveWire format. You will be asked for a name to convert the phone file to. ‚ïê‚ïê‚ïê 8.3. Dialing out ‚ïê‚ïê‚ïê Dialing out Once you have your phone directory set up, you can dial another computer. Dialing on LiveWire is very easy. Use the up and down arrow keys to position the highlight bar over the entry you wish to dial and press ENTER. LiveWire will automatically start dialing the selected number. If LiveWire is unable to connect for any reason, it will wait for a few seconds and redial automatically. This re-dialing process will repeat until either you press ESC and cancel the dialing or you establish connection with the other computer. Pressing ESC simply stops the dialing and returns you to the dialing directory. If the modem connects with another computer, the dialer will make a high pitched ring and display the message "Connect. Press any key..." Upon your pressing a key, LiveWire will return you to the terminal mode where you can talk directly with the remote computer. ‚ïê‚ïê‚ïê 8.4. Marking entries to dial multiple phone numbers ‚ïê‚ïê‚ïê Marking entries to dial multiple phone numbers LiveWire can also dial any number of entries you choose until it connects with one of the computers. This is done by marking the entries you wish to dial. Marking is also very simple. Position the highlight bar on the entry you wish to mark for dialing. Press the space bar. A check mark will appear next to the entry, indicating the entry has been marked. Note that the highlight bar automatically moves down to the next entry. Repeat this process until all of the entries you want to dial have been marked. Now, position the highlight bar on the entry you want to dial first, and press ENTER. The dialing will begin. The dialing will cycle through the marked entries until a connection is established. ‚ïê‚ïê‚ïê 8.5. Dialing commands ‚ïê‚ïê‚ïê Dialing commands dial entry [ENTER] The Start Dial command will start re-dialing either the entry the highlight bar is on or, if there are marked entries, the marked entries will be dialed. The dialer will continue re-dialing until it connects with another computer. To stop dialing, press ESC. edit entry [E] The Edit entry command will allow you to edit the entry the highlight bar is on or the entries that are marked. When you edit an entry, a window will appear containing the current entry's information. The following information can be edited by moving the highlight bar to that option and pressing enter. Name The name of the BBS or service associated with this entry. Number The phone number of there BBS or service for this entry. Speed Speed to set the modem before dialing. This is initially set to the highest baud rate available for your modem. Parity Parity to be used for the computer being called. N=No Parity, O=Odd Parity, E=Even Parity. Bits Number of data bits to be used when communicating to the computer being called. This may be either 7 or 8. Stop (bits) The number of stop bits to be used when communicating to the computer being called. This may be either 1 or 2. Duplex This option is the same as the echo on/off toggle. If duplex is FULL, echo is off. If duplex is HALF, echo is on. Script This field contains the name of the script file associated with this entry. When LiveWire connects to a service it checks if the script field is filled in. If specified this script file is started as soon as a connection has been established. NOTE: If a script file is specified that does not exist, LiveWire assumes it is supposed to start script learning and create a script file for automated logon. For more information about this feature read Using Script Learning. Password You may put your password here for reference. In addition this field corresponds to the macro {PASSWORD} and can be accessed by LiveWire REXX scripts. Protocol If you wish to have a default protocol for this service press ENTER while the highlight bar is on this option. A pop-up menu will appear listing all of the possible protocols. Movethe highlight bar to the default protocol for this entry and press ENTER. Emulation If you wish to have a default terminal emulation for this service press ENTER while the highlight bar is on this option. A pop-up menu will appear listing the terminal emulations LiveWire supports. Move the highlight bar to the default emulation for this entry and then press ENTER. Info file Specifies the name of the file used for additional information. If you wish to create additional information (such as comments or script information) with this dialing directory you may link a dialer entry with a filename. Last call LiveWire keeps the date of your last call to this system. You may manually edit this field. Total calls Total number of times you've called and successfully been connected to this service. mark [SPACEBAR] This command will mark or unmark the entry with the highlight bar on it. If the entry is not marked, it will become marked. If the entry is marked, it will be unmarked. Marking entries allows you to do mass dialing, deleting, and editing. Note that the mark/unmark command moves the highlight bar to the next entry automatically. This is to provide "power marking." In other words, holding down the spacebar will continue highlighting consecutive entries as long as the spacebar is held down. multiple mark [M] Multiple mark is a very useful and versatile command. It allows you to mark entries by name, part of a name, or entry number. For example, if you press M a window will appear asking for what to search for. Typing in 1,5,7 will mark entries 1, 5, and 7. Here are some more examples: 1,10,50,3 Marks entries 1, 10, 50, and 3 1,5..20 Marks entries 1, and all entries 5 through 20 1..20,25..200 Marks entries 1 through 20 and entries 25 through 200 DataMirage Marks all entries that contain "DataMirage" Data Marks all entries containing "Data." Note that this will match entries such as: "DataMirage," "The DATA Line," and "Dumb Data." There is no differentiation between caps and lowercase. 1,Data,5..20 Marks entry 1, all entries containing "Data," and entries 5 through20. unmark all [U] This command quickly unmarks all entries. delete entry [DEL] This command does just what it says -- deletes the highlighted or marked entries. This command will confirm deletion before it deletes the entry. After each entry is deleted, LiveWire will ask if you want to remove the blank entry and move the rest of the dialing directory up to fill the blank spot. insert entry [INS] Pressing INS inserts a blank entry wherever the highlight bar may be. Note that the new entry is created using the current configuration information (ie: the modem speed, parity, bits, stopbits, duplex, and the default protocol). sort entries [S] This command will sort your phone book A through Z, Z through A, or by total calls. All empty entries will be moved to the end of the list. eXchange entries [X] Exchange entries is a simple command that exchanges positions of two entries in the phone book. Simply mark two entries (no more, no less) and then press X. The position of the entries will be swapped. compRess directory [R] This command removes all blank entries from the dialing directory and compresses all entries so that they are contiguous. This command will not rearrange your phone book, it just moves entries up into spots where blank entries used to be. xFer entry info [F] This feature facilitates the exchange of phone numbers. This command sends basic information over the modem about the entry the highlight bar is on. This is useful when you want to tell someone the phone number of a BBS you like but do not want to type them the name or number. Simply go into your dialer, move the highlight bar to the entry you want to send them information about and press F. They will see on their end: :::>DataMirage BBS <#>(408) 578-5850 (2400-N-8-1) NOTE: If your friend is using LiveWire Communications also and he does not have this number in his dialing directory LiveWire will automatically ask him if he wants to add this number to his dialing directory! Print entries [P] This command will print your phone book to your printer. Upon pressing P, LiveWire will verify that your printer is on PRN (LPT1:). If you printer is on another printer port, communications port, or you want to print to a file, simply type in the destination of phone book list. For example, LPT2: for printer port 2, COM1: for com port 1, COM2: for com port 2, or FONBOOK.TXT to send the listing to a file called FONBOOK.TXT. Load other book [L] The load other phone book command will allow you to load or start another phone book. LiveWire can read LiveWire, Procomm, Procomm+, Qmodem 4.x and 5.0, Telix and Boyan phone directories. To load one of these phone books, just enter the path and name of the phone book. To start a new phone book, type in a new filename and a clean phone book will be made for you. coNvert to LW format [N] This command converts Boyan, Procomm, Procomm+, Qmodem 4.x/5.0, and LiveWire 2.0 phone directories to current LiveWire phone file format. First load the phone book you wish to convert. Then, press N and type in a new name to save the converted phone book as. undo last actions [!] This command accomplishes an undo of all of your previous commands up until the last time the dialing directory was saved to the disk. The dialing directory is saved automatically by LiveWire upon exiting the dialer or loading a new phone file. The undo command accomplishes its work by simply reloading the dialing directory without saving the current changes. View script [V] This command brings up the editor on the file specified in the script field for the highlighted entry. edit Dial codes [D] This command allows you to edit the dialing codes A through J. Pressing C brings up a window with the letters A through J listed with an entry field beside each. If you put "9," in the dialing code A, whenever the letter A appears in thenumber LiveWire is dialing (eg. A578-5850) the A will be replaced with "9,". In this way it is easy to define and change prefixes or postfixes on numbers. Defined dialing codes are listed at the top of the dialing directory. To exit the edit dialing codes window, press ESC. edit Comment file [C] This command brings up the editor on the file specified in the Info file field for the highlighted entry. ‚ïê‚ïê‚ïê 9. Transferring Files ‚ïê‚ïê‚ïê Transferring Files The transfer of files over a modem is called uploading and downloading. Uploading is the action of sending a file. Downloading is the action of receiving a file. Conventional phone lines and most data links are error prone. Static, echos, and unclean lines cause "garbage" to be transmitted. In order to transfer files, these errors must be corrected or your programs and data will be unusable. In order to catch these errors files are transferred with an error detection and correction scheme called a file transfer protocol. Both the remote and local sides must agree upon the protocol. Some common protocols are Zmodem, Ymodem, and Xmodem. Zmodem is by far the most efficient and robust protocol of these three. Zmodem and Ymodem allow you to send and receive multiple files at a time. A transmission of multiple files is called a "batch" file transfer. Sample upload session This section describes uploading a file to a remote system. Here we assume that the remote system is capable of initiating the transfer on its side. First, locate the file on your disk that you want to send. The filename to send might be C:\LW22\LW22.EXE. Next, tell your remote that you wish to send a file. Usually this is done by telling it you want to upload. Then, tell the remote which protocol you want to use. The most preferable protocol is Zmodem. For more information, consult the manual or help system for your remote host. When the remote end tells you to begin uploading, press the PageUp (for UPload) key on your keyboard. A list of protocols will appear for your to choose from. Choose the protocol that matches the one you selected for your remote. Once a protocol has been established, you will be prompted for the files you wish to send. If the protocol is Xmodem, Xmodem CRC, or Xmodem-1K youcan only send one file. If the protocol is Zmodem or Ymodem you may enter as many files as you wish. Optionally, you may use the file navigator to pick files to send from a list. Refer to the section File Navigator for more information. When you are finished entering files you can begin the transfer by pressing ENTER. During the file transfer a small window should appear in the lower right hand corner of your screen showing you statistics about the file transfer. To abort the file transfer, press ESC at any time. When the file transfer is completed the window will disappear and a bell will sound. Sample download session This section describes downloading a file from a remote system. Here we assume that the remote system is capable of initiating the transfer on its side. First, find the filenames or filenames you want on the remote side. Next, tell the remote that you wish to receive some files. Usually this is done by telling it you want to download. Then, tell the remote which protocol you want to use. The most preferable protocol is Zmodem. For more information, consult the manual or help system for your remote host. The remote end will ask you which files you want to download. Type in the filenames you wish to receive and tell the remote to begin the transfer. At this point, if you are using Zmodem the downloading will automatically begin. If you are downloading using Ymodem or Xmodem some extra work is required. The Ymodem protocol will not start up automatically, so you must press the Page Down key (for Download) and select the Ymodem protocol. At this point the download will begin. The Xmodem protocol (including CRC and 1k) will only receive one file at a time and does not start automatically either. To begin downloading you must press the PageDown key (for Download) and select the Xmodem protocol. You will then be prompted for a filename to download to. Type in one filename, and press ENTER. At this point the download will begin. During the file transfer a small window should appear in the lower right handcorner of your screen showing you statistics about the file transfer. To abort the file transfer, press ESC at any time. When the file transfer is completed the window will disappear and a bell will sound. ‚ïê‚ïê‚ïê 10. File Navigator ‚ïê‚ïê‚ïê File Navigator Navigator features LiveWire 2.2 contains a new feature called the File Navigator. The File Navigator is a file and directory selection window with a multi-threaded interface capable of handling long file and directory names. File Navigator can be used to select files to upload, find a file from a file spec window, or change directories. Initiating the navigator The navigator may be used in three different areas in LiveWire. 1. During batch uploads the batch send window will prompt for a filename. Pressing F3 in this window brings up the file navigator. 2. Any file specification window (IE: Load phone book, run script, view file, save scroll-back, capture file, etc) is capable of invoking the file navigator. Pressing F3 or ALT-N in a file specification window brings up the file navigator. 3. The "Change dir" command brings up the file navigator automatically for directory selection. When the navigator is initiated it contains two main windows. The window on the right contains the files for the current directory. The longer window on the left contains a directory tree structure. When the navigator is first started files are displayed for the current directory while the directory tree structure is being built in the background. While the directory tree is being built, the files window may be used to select files and move between directories. Navigating the files window The file window contains at most two columns of files. If more files exist, an arrow will appear at the lower right hand corner of the files window. Using the Arrow, PgUp, PgDn, and Home keys the highlight bar may be moved over any file in the list. The highlight bar will also jump directly to a specified file by pressing the first letter of the filename on the keyboard. For example, pressing L might bring the highlight bar to the file LW22.ZIP. Once the highlight bar is over a file it may be selected by pressing ENTER.When multiple files can be selected, pressing the spacebar puts a mark next to the currently highlighted file. Marking several files in this way, then pressing ENTER causes all of the files to be selected. Directories in the file window are denoted by <DIR> after the directory name. Pressing ENTER while the highlight bar is over a directory causes the navigator to enter that directory. The special directory called ".." is available in all directory listings. Pressing ENTER while over ".." causes the navigator to leave the current directory and go back to its parent. Pressing the Tab key will change windows to the directory tree window. Navigating the directory tree window The window on the left is a tree-like blow-out of the directories on the hard drive. If the tree is wider than the window, only partial directory names will be visible. A scroll-bar on the right indicates the position of the highlight bar in relation to the entire directory tree structure. The directory tree may be traversed by pressing the Arrow, PgUp, Pgdn, Home and End keys to move the highlight bar. If the highlight bar is at the top or bottom of the window, the directory tree will scroll to bring more directories into view. As the highlight bar moves through the directory tree files for each directory to appear in the files window on the right. To change to another drive, press D. A list of valid drives will appear. Press the letter of the drive to change to. If a directory needs to be selected (as opposed to a file), pressing ENTER will select the highlighted directory. Pressing the Tab key will change windows to the files window. Exiting the file navigator Once the desired file(s) or directory has been located, pressing ENTER selects those directories and exits the file navigator. To exit the navigator without selecting a file or directory, press ESC. ‚ïê‚ïê‚ïê 11. File Transfer Monitor ‚ïê‚ïê‚ïê File Transfer Monitor Included in the LiveWire 2.2 package is a Presentation Manager File Transfer Monitor. The file transfer monitor was designed so that background file transfers could be easily monitored while using the applications in the Work Place Shell. To start the file transfer monitor, double click on its icon before beginning the file transfer. You may also choose to keep the file transfer monitor running all the time as a minimized window. When minimized, the file transfer window changes its title to show the percent transferred of the current file. The file transfer monitor takes up very little memory and almost no CPU. It may be minimized or displayed even when LiveWire is not active. When a LiveWire session detects the presence of the file transfer monitor it connects through a named pipe. The named pipe remains connected until LiveWire exits or the file transfer monitor is closed. Please note that the file transfer monitor is a simple utility for the text-based version of LiveWire. It by no means attempts to make LiveWire a PM application, and is in no way related to the PM version of LiveWire currently being developed. ‚ïê‚ïê‚ïê 12. Named Pipes ‚ïê‚ïê‚ïê Named Pipes Named pipes are a communications facility provided by OS/2. Named pipes connect two different programs through a data pipe in the computer. The data pipe can be thought of as a real-world pipe with two people standing on either end. If one person speaks down the pipe, the other person hears what the other has to say, and vice-versa. One use for named pipes can be used to connect your local computer to a single modem in a modem pool (collection of many modems). This is useful if there are a lot of employees and only a few modems. Employees can use a modem through named pipe, effectively sharing them with everyone in the company. Named pipes are also used for running programs remotely. OS2You by Mikael Wahlgren of Ridax programming allows you to run and control a program on a distant computer. The program can be run over a named pipe. To set up a connection to a named pipe in LiveWire two things must be set up in the port configuration. First, go into the configuration program under "Modem" and "Port Setup." Then, change your communications device to PIPE. Lastly, set the "Pipe Name" field to the name of the pipe you want to connect to. Pipe names always are of the format \PIPE\<pipename>. To access network pipes the pipe name format is \\<computername>\PIPE\<pipename>. When you exit configuration LiveWire will attempt to connect to the named pipe. If the connection attempt is unsuccessful the message "PORT NOT READY" will appear on the status line and the status line will say "Offline". If the connect is successful, the time spent connected will be displayed on the status line. To disconnect from a named pipe connection, press the hangup key sequence, usually ALT-H. A window saying "Disconnecting pipe" will appear, and the status line should read "Offline." If, during a connection, the remote disconnects the pipe the status line will report that you are "Offline". To attempt a re-connection to a named pipe, press the hangup key sequence again (usually ALT-H). A window saying "Attempting to reconnect pipe" will appear. If the connect was successful, the status line will indicate the connection has been established by displaying the time connected. For more information on how to setup named pipes refer to your remote's manual or online help. ‚ïê‚ïê‚ïê 13. REXX Scripting Functions ‚ïê‚ïê‚ïê REXX Scripting Functions Starting a script LiveWire includes support for the OS/2 REXX procedure language. LiveWire scripts may be started in one of three ways. Scripts may be started using the command line parameter /Sscriptname where <scriptname> is the name of the script to start. Scripts may be started from within LiveWire in two ways, by invoking them from the terminal mode or by linking them to a dialing entry. When the dialer makes a connection to a particular service, its script is automatically started. Description of functions REXX is a very powerful script language provided with OS/2. LiveWire extends the power of REXX by providing a full suite of functions designed to control communications sessions. Beneath this item is a list of functions that are added to REXX scripts executed inside LiveWire. There are two special commands, GetLW and SetLW, which get and set LiveWire attributes. An attribute is any toggle or setting configurable in LiveWire. These attributes include cursor location, screen color, phone book entries, timeout values, terminal emulations, capture, and log. A complete list and description of all attributes are available beneath the SetLW function. The rest of the commands handle LiveWire functions, such as hanging up, dialing, and exiting. Complete descriptions are given beneath this panel. Some functions include examples, but the best examples are provided in the host mode script (HOST.CMD) provided with LiveWire 2.2. REXX extensions REXX scripts are plain ASCII text, and must end with the .CMD extension. LiveWire registers itself as a sub-command handler for REXX programs run inside LiveWire. LiveWire passes on any commands that are not valid functions to the OS/2 command interpreter. Standard REXX output, tracing output, and error output are mapped to LiveWire's terminal screen. In addition, LiveWire redirects the standard REXX output command SAY to to the LiveWire terminal screen. REXX scripts run from inside LiveWire can be further extended by third party extensions in order to add features such as multi-threading or PM interfaces. This manual does not include a complete description of the REXX scripting language. More information on the REXX scripting language is distributed with OS/2 as the INF file "REXX Information" normally kept in the Information folder. ‚ïê‚ïê‚ïê 13.1. Script commands quick reference ‚ïê‚ïê‚ïê Script commands quick reference The following are all LiveWire-defined script functions and attributes. This page is for quick reference only, see full documentation on each function and attribute for more information. Functions defined by LiveWire AnsiColorLW(fg, bg) ClrScrLW() DelayLW(ms) DialLW(markstring) DiseLW(string) DispLW(string) DoMacroLW(keyname) DumpScreenLW(filename) FindLW(string, string, ...) FlushBufferLW() GetKeyLocalLW() GetKeyLW() GetKeyRemoteLW() GetLW(attribute) GetStrLocalLW(string, maxlen) GetStrLW(string, maxlen) GetStrRemoteLW(string, maxlen) HangUpLW() LogLW(string) ReceiveFilesLW(protocol, path) SendBreakLW() SendFilesLW(protocol, filelist) SetLW(attribute, attribute_value) SleepLW(seconds) WaitTimeLW(hr, min) Attributes for GetLW and SetLW BgColor BSisDEL Capture CaptureFile ConnectPopup ConnectTimeout CurrentDir CurrentDisk CursorX CursorY DataBits DialerBits DialerDuplex DialerEmulation DialerInfoFile DialerLastCall DialerName DialerNumber DialerOnStartup DialerParity DialerPassword DialerPhoneNumber DialerProtocol DialerScriptFile DialerSpeed DialerStop DialerTotalCalls DLDir DoorWay DumpFile Echo EchoBack Editor Emulation FgColor IgnoreCarrier Linefeeds LocalOnly LocalOnly LockedPort Log LogFile MacroFile Music Online Pacing Parity PhoneFile PipeName Port Printer RedialWait RtsCts ScrollBack Speed StatusLine StopBits TimeOut ULDir XlateFile XonXoff ‚ïê‚ïê‚ïê 13.2. GetLW(attribute) ‚ïê‚ïê‚ïê GetLW(attribute) GetLW takes an attribute as an argument and returns the current actual value of the passed attribute. If the value of the attribute is undefined, then the return value is the empty string or "". ‚ïê‚ïê‚ïê 13.3. SetLW(attribute, attribute_value) ‚ïê‚ïê‚ïê SetLW(attribute,attribute_value) SetLW sets a majority of LiveWire program attributes. It takes an attribute and a corresponding attribute value as arguments. A call to SetLW will attempt to set the passed LiveWire program attribute to the passed attribute value. If SUCCESS, the return value is the empty string. Listed as sub-entries of this command are all the attribute that are Getable and Setable in LiveWire. ‚ïê‚ïê‚ïê 13.3.1. TimeOut ‚ïê‚ïê‚ïê TimeOut TimeOut - represents the LiveWire timeout value in seconds. TimeOut must be set to an integer value. Example: SetLW( TimeOut, 45 ); This sets TimeOut to 45 seconds. If TimeOut is set to 0, then there is no timeout effect in LiveWire at all. ‚ïê‚ïê‚ïê 13.3.2. Echoback ‚ïê‚ïê‚ïê Echoback EchoBack - determines whether or not input received over the communications line should be echoed back. Example: SetLW( EchoBack, On ); This toggles EchoBack to ON. Similarly, it may be set to OFF with SetLW( EchoBack, Off ); Integer values may also replace the arguments, where 1=ON and 0=OFF. By default, EchoBack is OFF. ‚ïê‚ïê‚ïê 13.3.3. FgColor ‚ïê‚ïê‚ïê FgColor FgColor - represents the current local LiveWire foreground color. May be set with colors in the range from 0 to 15, inclusive, integers values only. Example: SetLW( FgColor, 8 ); This set the foreground color to Dark Grey. The following is the foreground coloring scheme: Value Color ----- ---- 0 Black 1 Blue 2 Green 3 Cyan 4 Red 5 Magenta 6 Brown 7 White 8 Dark Grey 9 Light Blue 10 Bright Green 11 Bright Blue 12 Bright Red 13 Bright Magenta 14 Yellow 15 White ‚ïê‚ïê‚ïê 13.3.4. BgColor ‚ïê‚ïê‚ïê BgColor BgColor - represents the current local LiveWire background color. May be set with the same values as FgColor, except only the range from 1 to 7. Note: Clearing the screen after modifying background colors will cause the entire screen to immediately change to that background color. ‚ïê‚ïê‚ïê 13.3.5. CursorX ‚ïê‚ïê‚ïê CursorX CursorX - the cursor X position, where X_Coordinate is an integer value in the range 1 to 80, inclusive. ‚ïê‚ïê‚ïê 13.3.6. CursorY ‚ïê‚ïê‚ïê CursorY CursorY - the cursor position, where Y_Coordinate is an integer value in the range 1 to screen length, inclusive. ‚ïê‚ïê‚ïê 13.3.7. Online ‚ïê‚ïê‚ïê Online Online - determines whether or not LiveWire is currently online. If online, then the return value is 1. Otherwise, if not online, then the return value is 0. Note: This attribute is only defined for GetLW. ‚ïê‚ïê‚ïê 13.3.8. CurrentDir ‚ïê‚ïê‚ïê CurrentDir CurrentDir - represents the current directory. Example: SetLW( CurrentDir, "C:\LiveWire\Info" ); ‚ïê‚ïê‚ïê 13.3.9. CurrentDisk ‚ïê‚ïê‚ïê CurrentDisk CurrentDisk - represents the current default disk drive. Example: SetLW( CurrentDisk, "D:" );. ‚ïê‚ïê‚ïê 13.3.10. Emulation ‚ïê‚ïê‚ïê Emulation Emulation - represents the current emulation. Emulation values are as follows: 0=TTY, 1=ANSI-BBS, 2=OS2YOU, 3=VT-102 4=0+ Avatar. Example: SetLW( Emulation, 1 ); This sets the current emulation to ANSI-BBS. ‚ïê‚ïê‚ïê 13.3.11. Capture ‚ïê‚ïê‚ïê Capture Capture - determines whether or not LiveWire should capture sessions. May be set with ON/OFF, 1/0, where 1=Start Capture and 0=Stop capture. A third optional parameter (only available with ON setting) specifies the file to capture to. Note: When used with GetLW, only returns 1 or 0. Example: SetLW(Capture, ON); Example: SetLW(Capture, ON, "Cap.Fil"); Example: SetLW(Capture, OFF); ‚ïê‚ïê‚ïê 13.3.12. CaptureFile ‚ïê‚ïê‚ïê CaptureFile CaptureFile - represents the name of the current capture file. ‚ïê‚ïê‚ïê 13.3.13. LogFile ‚ïê‚ïê‚ïê LogFile LogFile - represents the name of the current log file. ‚ïê‚ïê‚ïê 13.3.14. Log ‚ïê‚ïê‚ïê Log Log - determines whether or not LiveWire's log feature is active. ‚ïê‚ïê‚ïê 13.3.15. Echo ‚ïê‚ïê‚ïê Echo Echo - determines whether or not the echo (display) of key presses is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. Example: SetLW(Echo, On); ‚ïê‚ïê‚ïê 13.3.16. Linefeeds ‚ïê‚ïê‚ïê Linefeeds Linefeeds - determines whether or not automatic line feeds is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: when used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.17. RtsCts ‚ïê‚ïê‚ïê RtsCts RtsCts - determines whether or not RTS/CTS flow control is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.18. StatusLine ‚ïê‚ïê‚ïê StatusLine StatusLine - determines whether or not the status line is turned on or off. Maybe set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.19. DoorWay ‚ïê‚ïê‚ïê Doorway Doorway - determines whether or not doorway mode is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.20. Printer ‚ïê‚ïê‚ïê Printer Printer - determines whether or not printer capture is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.21. BSisDEL ‚ïê‚ïê‚ïê BSisDEL BSisDEL - determines whether or not the backspace key is equated with the DEL key. May be set with attribute values On or Off, 1 or 0, True or False. By default, BSisDel is set OFF. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.22. PhoneFile ‚ïê‚ïê‚ïê PhoneFile PhoneFile - represents the current phone directory file. ‚ïê‚ïê‚ïê 13.3.23. MacroFile ‚ïê‚ïê‚ïê MacroFile MacroFile - represents the current macro file. ‚ïê‚ïê‚ïê 13.3.24. XlateFile ‚ïê‚ïê‚ïê XlateFile XlateFile - represents the current translation table file. ‚ïê‚ïê‚ïê 13.3.25. Port ‚ïê‚ïê‚ïê Port Port - represents the current communications port being used. ‚ïê‚ïê‚ïê 13.3.26. Speed ‚ïê‚ïê‚ïê Speed Speed - represents the current modem speed. May be set with any common baud rate. Example: SetLW(Speed, 14400); This sets the modem speed to 14000 baud. ‚ïê‚ïê‚ïê 13.3.27. Parity ‚ïê‚ïê‚ïê Parity Parity - represents the current parity checking in effect. Parity values are as follows: 0=No Parity 1=Even Parity 2=Odd Parity ‚ïê‚ïê‚ïê 13.3.28. DataBits ‚ïê‚ïê‚ïê DataBits DataBits - represents the number of databits (7 or 8) used in communication. The number of databits must be integer values of either 7 or 8. ‚ïê‚ïê‚ïê 13.3.29. StopBits ‚ïê‚ïê‚ïê StopBits StopBits - represents the number of stop bits used in communication. The number of stop bits must be integer values of either 1 or 2. ‚ïê‚ïê‚ïê 13.3.30. LockedPort ‚ïê‚ïê‚ïê LockedPort LockedPort - determines whether or not the modem baud rate is locked. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.31. PipeName ‚ïê‚ïê‚ïê PipeName PipeName - represents the name of the current named pipe. ‚ïê‚ïê‚ïê 13.3.32. XonXoff ‚ïê‚ïê‚ïê XonXoff XonXoff - determines whether or not flow control is on or off. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.33. IgnoreCarrier ‚ïê‚ïê‚ïê IgnoreCarrier IgnoreCarrier - determines whether or not to ignore carrier on downloads and uploads. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.34. ConnectPopup ‚ïê‚ïê‚ïê ConnectPopup ConnectPopup - determines whether or not to popup a message when connect to other host. May be set with attribute values On or Off, 1 or 0, True or False. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.35. Music ‚ïê‚ïê‚ïê Music Music - determines whether or not music is on or off. May be set with attribute values On or Off, 1 or 0, True or False. By default, music is ON. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.36. DialerOnStartup ‚ïê‚ïê‚ïê DialerOnStartup DialerOnStartup - determines whether or not to dial a specified phone directory entry immediately upon LiveWire startup. ‚ïê‚ïê‚ïê 13.3.37. ScrollBack ‚ïê‚ïê‚ïê ScrollBack ScrollBack - determines whether or not the scroll back buffer is on or off. May be set with attribute values On or Off, 1 or 0, True or False. By default scrollback, is ON. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.38. ConnectTimeout ‚ïê‚ïê‚ïê ConnectTimeout ConnectTimeout - represents the maximum amount of time LiveWire will wait to connect to each computer system dialed. ‚ïê‚ïê‚ïê 13.3.39. RedialWait ‚ïê‚ïê‚ïê RedialWait RedialWait - represents the amount of time LiveWire will wait between dialing attempts. ‚ïê‚ïê‚ïê 13.3.40. Pacing ‚ïê‚ïê‚ïê Pacing Pacing - sets the character inter-pacing value. If the pacing value is set to 0, then pacing has no effect. Must be set with integer values where the pacing rate is effectively measured in milliseconds. ‚ïê‚ïê‚ïê 13.3.41. Editor ‚ïê‚ïê‚ïê Editor Editor - represents the full path of the current default LiveWire text editor. ‚ïê‚ïê‚ïê 13.3.42. ULDir ‚ïê‚ïê‚ïê ULDir ULDir - represents the directory where uploaded files will go. If this value is "", then the upload directory is the current directory. ‚ïê‚ïê‚ïê 13.3.43. DLDir ‚ïê‚ïê‚ïê DLDir DLDir - represents the directory where downloaded files will go. If this value is "", then the download directory is the current directory. ‚ïê‚ïê‚ïê 13.3.44. DumpFile ‚ïê‚ïê‚ïê DumpFile DumpFile - represents current dump file name including path. ‚ïê‚ïê‚ïê 13.3.45. MacroFile ‚ïê‚ïê‚ïê MacroFile MacroFile - represents the name of the current macro file including path. ‚ïê‚ïê‚ïê 13.3.46. LocalOnly ‚ïê‚ïê‚ïê LocalOnly LocalOnly - determines whether or not your script should send output to the modem. When set to 0, Off, or False output from your script may be sent to the modem. If set to 1, On, or True output is restricted to the local system. By default, LocalOnly is set to OFF. Note: When used with GetLW, only returns 1 or 0. ‚ïê‚ïê‚ïê 13.3.47. DialerNumber ‚ïê‚ïê‚ïê DialerNumber DialerNumber - The current dialing entry number being modified. If the script was run automatically from the dialer after connecting, this attribute will be set to the dialing entry connected to. ‚ïê‚ïê‚ïê 13.3.48. DialerName ‚ïê‚ïê‚ïê DialerName DialerName - The name of the current entry in the dialing directory. ‚ïê‚ïê‚ïê 13.3.49. DialerPhoneNumber ‚ïê‚ïê‚ïê DialerPhoneNumber DialerPhoneNumber - The number of the current entry in the dialing directory. ‚ïê‚ïê‚ïê 13.3.50. DialerInfoFile ‚ïê‚ïê‚ïê DialerInfoFile DialerInfoFile - The name of the comments/information file of the current entry. ‚ïê‚ïê‚ïê 13.3.51. DialerScriptFile ‚ïê‚ïê‚ïê DialerScriptFile DialerScriptFile - The name of the script file of the current entry. ‚ïê‚ïê‚ïê 13.3.52. DialerSpeed ‚ïê‚ïê‚ïê DialerSpeed DialerSpeed - The communications speed of the current entry. ‚ïê‚ïê‚ïê 13.3.53. DialerParity ‚ïê‚ïê‚ïê DialerParity DialerParity - The parity of the current entry. (N, E, or O) ‚ïê‚ïê‚ïê 13.3.54. DialerBits ‚ïê‚ïê‚ïê DialerBits DialerBits - The data bits of the current entry. (7 or 8) ‚ïê‚ïê‚ïê 13.3.55. DialerStop ‚ïê‚ïê‚ïê DialerStop DialerStop - The stop bits of the current entry. (1 or 2) ‚ïê‚ïê‚ïê 13.3.56. DialerDuplex ‚ïê‚ïê‚ïê DialerDuplex DialerDuplex - The duplex of the current entry. (F=Full, H=Half) ‚ïê‚ïê‚ïê 13.3.57. DialerPassword ‚ïê‚ïê‚ïê DialerPassword DialerPassword - The password of the current entry. ‚ïê‚ïê‚ïê 13.3.58. DialerProtocol ‚ïê‚ïê‚ïê DialerProtocol DialerProtocol - The hotkey (highlighted character in the menu) of the protocol of the current entry. (EG: Zmodem is Z, Xmodem-1K is 1) ‚ïê‚ïê‚ïê 13.3.59. DialerEmulation ‚ïê‚ïê‚ïê DialerEmulation DialerEmulation - The emulation of the current entry. ‚ïê‚ïê‚ïê 13.3.60. DialerLastCall ‚ïê‚ïê‚ïê DialerLastCall DialerLastCall - The date of the last call of the current entry. ‚ïê‚ïê‚ïê 13.3.61. DialerTotalCalls ‚ïê‚ïê‚ïê DialerTotalCalls DialerTotalCalls - The number of total calls to the current entry. ‚ïê‚ïê‚ïê 13.4. DispLW(string) ‚ïê‚ïê‚ïê DispLW(string) Disp(string) - displays a string locally (i.e. does not send it over the modem), where <string> is a string of text enclosed in a pair of quotes or the name of a string variable. The passed string may include any special control characters following special characters, for example: ^M = carriage return ^J = line feed ^G = Bell ^M^J would be a carriage return immediately followed by a line feed. Example: DispLW("This will display a string and drop down to the next line^M^J"); ‚ïê‚ïê‚ïê 13.5. SendLW(string) ‚ïê‚ïê‚ïê SendLW(string) SendLW(string) - sends a string over the modem, but does not display it to the screen, where <string> is a string of text enclosed in a pair of quotes or the name of a string variable. The passed string may include any special control characters following special characters, for example: ^M = carriage return (or ENTER) ^J = line feed ^G = Bell ^M^J would be a carriage return immediately followed by a line feed. Example: DispLW("This will send a string to the modem and press [ENTER]^M"); ‚ïê‚ïê‚ïê 13.6. DiseLW(string) ‚ïê‚ïê‚ïê DiseLW(string) DiseLW(str) - sends a string over the modem and displays it locally as well, where <str> is a string of text enclosed in a pair of quotes or the name of a string variable. The passed string may include any special control characters following special characters, for example: ^M = carriage return (or ENTER) ^J = line feed ^G = Bell ^M^J would be a carriage return immediately followed by a line feed. Example: DispLW("This will send a string to the modem and display it on the LiveWire screen^M"); ‚ïê‚ïê‚ïê 13.7. FindLW(string, string, ) ‚ïê‚ïê‚ïê FindLW(string, string, ...) FindLW(string, string, ... ) - Waits until one of the strings <string> is found in the information being received over the modem, where <string> is a string of text enclosed in a pair of quotes or the name of a string variable. Find may look for up to 10 strings. The command fails if it cannot find one of the strings in the amount of time specified in the TIMEOUT variable. Upon timeout, FindLW returns the string "TIMEOUT", otherwise it returns the string it found. Note that if timeout is zero, FindLW will not timeout. Note: The passed strings may include the following special characters: ^M = carriage return, ^J = line feed, and ^G = Bell. For example, ^M^J would be a carriage return immediately followed by a line feed. ‚ïê‚ïê‚ïê 13.8. GetKeyLW() ‚ïê‚ïê‚ïê GetKeyLW() GetKeyLW() - returns a single keystroke of input from either the local end or remote computer. ‚ïê‚ïê‚ïê 13.9. GetKeyLocalLW() ‚ïê‚ïê‚ïê GetKeyLocalLW() GetKeyLocalLW() - returns a singe keystroke of input from the local end of LiveWire. ‚ïê‚ïê‚ïê 13.10. GetKeyRemoteLW() ‚ïê‚ïê‚ïê GetKeyRemoteLW() GetKeyRemoteLW( ) - returns a single keystroke of input from the remote computer. ‚ïê‚ïê‚ïê 13.11. GetStrLW(string, maxlen) ‚ïê‚ïê‚ïê GetStrLW(string, maxlen) GetStrLW(string, maxlen) - receives a full string from either the local or remote end and returns a string typed or edited by the user. The string is ended when <ENTER> is pressed. If a string <string> is specified, the string appears for the user to edit. The string will not be allowed to exceed the maximum length specified by <maxlen>. The size of the passed string <string> cannot exceed the length. specified by <maxlen>. By default, <maxlen> is 78. Example: Name=GetStrLW("Les",15); Would display the name "Les" for editing. Up to a maximum of 15 characters can be entered. When <ENTER> is pressed the variable "Name" gets the edited string. ‚ïê‚ïê‚ïê 13.12. GetStrLocalLW(string, maxlen) ‚ïê‚ïê‚ïê GetStrLocalLW(string, maxlen) GetStrLocalLW(string, maxlen ) - this command is similar to GetStrLW except that GetStrLocalLW gets a string only from the local keyboard. Also, the editing provided is much more powerful than GetStrLW since it allows full editing of the variable with arrow, insert, and delete keys. ‚ïê‚ïê‚ïê 13.13. GetStrRemoteLW(string, maxlen) ‚ïê‚ïê‚ïê GetStrRemoteLW(string, maxlen) GetStrRemoteLW(string, maxlen) - similar to GetStrLW, except this command only receives a string from the remote computer. ‚ïê‚ïê‚ïê 13.14. DialLW(markstring) ‚ïê‚ïê‚ïê DialLW(markstring) DialLW(markstring) - marks and dials a range of entries based upon a given mark string, specified by the string <markstring>. The mark string allows you to mark entries by name, part of a name, or entry number. Here are some examples: 1,10,50,3 Marks entries 1, 10, 50, and 3 1,5..20 Marks entries 1, and all entries 5 through 20, inclusive. 1..20,25..200 Marks entries 1 through 20 and 25 through 200, inclusive. DataMirage Marks all entries that contain "DataMirage" Data Marks all entries that contain "Data". Note that this will match entries such as "DataMirage", The DATA Line", and "My Data". Also, this is case insensitive. 1,Data,5..20 Marks entry 1, all entries containing "Data", and entries 5 through 20, inclusive. ‚ïê‚ïê‚ïê 13.15. ClrScrLW() ‚ïê‚ïê‚ïê ClrScrLW() ClrScrLW() - clears the local screen. ‚ïê‚ïê‚ïê 13.16. SendBreakLW() ‚ïê‚ïê‚ïê SendBreakLW() SendBreakLW() - sends a break signal over the modem for 1/4 of a second. ‚ïê‚ïê‚ïê 13.17. SendFilesLW(protocol, filelist) ‚ïê‚ïê‚ïê SendFilesLW(protocol, filelist) SendFilesLW(protocol, filelist) Sends (uploads) one or more files over the modem using the specified protocol, where <protocol> is a string variable that should contain a single character which is the hotkey of the protocol to use. The hotkeys are the letters that are highlighted in the protocol listing when you press <PgUp>. For example, Zmodem would be Z. Xmodem would be X. Xmodem-1K would be 1. <filelist> is a list of quote-enclosed files and their paths to send all in one string. Long filenames and filenames with spaces are accepted. If you wish to send only one file, there is no need to enclose the file in double quotes. Wildcards are not accepted. For example: SendFilesLW(Z, '"C:\COMMAND.COM" "F:\LW22\LW22.EXE"'); SendFilesLW(Z, 'C:\AUTOEXEC.BAT'); Returns "0" on success, otherwise failure. Specific failure codes may be added in future versions of LiveWire. ‚ïê‚ïê‚ïê 13.18. ReceiveFilesLW(protocol, path) ‚ïê‚ïê‚ïê ReceiveFilesLW(protocol, path) ReceiveFilesLW(protocol, path) Receives (downloads) one or more files over the modem using the specified protocol, where <protocol> is a string variable that should contain a single character which is the hotkey of the protocol to use. The hotkeys are the letters that are highlighted in the protocol listing when you press <PgDn>. For example, Zmodem would be Z. Xmodem would be X. Xmodem-1K would be 1. <path> is the directory to place the received files into for batch protocols. For single-file protocols (Xmodem, Xmodem-1K, Xmodem CRC), <path> is the full filespec of the file being received. If <path> is the empty string (""), received files are placed in the default download directory. For example: ReceiveFilesLW(Z, ""); ReceiveFilesLW(Z, "C:\DOS"); ReceiveFilesLW(X, "C:\DOS\COMMAND.COM"); Returns "0" on success, otherwise failure. Specific failure codes may be added in future versions of LiveWire. ‚ïê‚ïê‚ïê 13.19. AnsiColorLW(fg, bg) ‚ïê‚ïê‚ïê AnsiColorLW(fg, bg) AnsiColorLW(fg,bg) - sends an ANSI code over the modem that changes the remote terminal color. <fg> is the foreground color. <bg> is the background color. ‚ïê‚ïê‚ïê 13.20. DumpScreenLW(filename) ‚ïê‚ïê‚ïê DumpScreenLW(filename) DumpScreenLW(filename) - dumps the current screen to <filename>, the specified dump file. ‚ïê‚ïê‚ïê 13.21. ExitLW() ‚ïê‚ïê‚ïê ExitLW() ExitLW() - exits the LiveWire program. ‚ïê‚ïê‚ïê 13.22. DelayLW(ms) ‚ïê‚ïê‚ïê DelayLW(ms) DelayLW(ms) - delays for <ms> milliseconds before resuming the script. ‚ïê‚ïê‚ïê 13.23. SleepLW(seconds) ‚ïê‚ïê‚ïê SleepLW(seconds) SleepLW(seconds) - sleeps (does nothing) for <seconds> amount of time before resuming the script. ‚ïê‚ïê‚ïê 13.24. WaitTimeLW(hr, min) ‚ïê‚ïê‚ïê WaitTimeLW(hr, min) WaitTime(hr, min) - waits until the current time is <hr>:<mn> (in 24 hour military time) before resuming the script. During the wait time, the session continues. Therefore, this command can be used to capture data from a start time to end time. ‚ïê‚ïê‚ïê 13.25. HangUpLW() ‚ïê‚ïê‚ïê HangUpLW() HangUpLW() - attempts to disconnect the current modem session. Returns "1" on success (modem reports offline status), "0" on failure (modem reports online status). ‚ïê‚ïê‚ïê 13.26. DoMacroLW() ‚ïê‚ïê‚ïê DoMacroLW() DoMacroLW(<key name>) - executes a macro given a key name. Example: DoMacroLW("F1"); DoMacroLW("ALT-X"); Warning: This function has had minimal testing and is not guaranteed to work except for macros containing strictly ASCII text or the {PASSWORD} command. All other macro commands may or may not work. ‚ïê‚ïê‚ïê 13.27. FlushBufferLW() ‚ïê‚ïê‚ïê FlushBufferLW() FlushBufferLW() - Flushes the incoming and outgoing data buffers. ‚ïê‚ïê‚ïê 13.28. LogLW() ‚ïê‚ïê‚ïê LogLW() LogLW(<str>) - Creates an entry in the log file. The time and date are automatically stamped. Example: LogLW("Hanging up"); LogLW("Phone rang"); ‚ïê‚ïê‚ïê 14. Learning scripts ‚ïê‚ïê‚ïê Learning scripts LiveWire has the capability to record part or all of a communications session and play it back automatically. This is called script learn. LiveWire accomplishes this "recording" by assuming that the service you are connected to will be sending a prompt (eg: Enter Your Name or Press Any Key...) and that you will respond by typing a response and pressing ENTER. LiveWire remembers what you type at each prompt and responds in the same manner next time it sees these prompts. The following runs through an example learning session: The first thing you must do is find a service you want to call in your phone directory and put a filename in the "Script" field. To edit this entry press "E" while the highlight bar is on the entry. When the edit window appears, move your highlight bar to the entry "Script" and press ENTER. Now type a filename, ending with the extension .CMD, into this field and press ENTER. Then press Esc to save this entry. Now, dial the service. Note that as you dial an "L" appears next to the entry where a check mark normally appears. This means that LiveWire will automatically start learning as soon as you get onto the service. Logon normally to the service, but take care to note of how much of your logon you want LiveWire to remember. For example, on most services you would only need LiveWire to remember when you type your name and password. Beyond this (reading bulletins and messages) the service you call probably changes daily. If so, LiveWire will become confused. It isn't smart enough to adapt to these changes. When you are ready to have LiveWire stop learning, look at the status line on your screen. It will tell you what keys you need to press to stop script learning. That's it! Next time you call the same service LiveWire should automatically replay what it learned, key for key. If for some reason LiveWire did not learn correctly or you made a mistake while it was learning you can change the name of the script filename in the phone book entry or erase the script file. TIPS FOR LEARNING: LiveWire makes the assumption that when you press ENTER you are finished typing so... - Press ENTER after each prompt - The use of hotkeys (selection of an option without having to press ENTER) may not work ‚ïê‚ïê‚ïê 14.1. Editing a learned script file ‚ïê‚ïê‚ïê Editing a learned script file Editing a script file associated with a service in the dialer is simple. Go into the dialer and move the highlight bar to the service, then press the V (for View Script) key. After a few seconds an editor will come up with the learned script. If you intend to fix the script, the first thing you need to know is at what point the script is failing. For example, if the script never responds to a "PASSWORD:" prompt then you know that it is not recognizing the prompt correctly. Move your cursor to the place in the script which has the command to find the password prompt. This may look like: FindLW("PASSWORD:"); Any small difference in the actual prompt and the prompt LiveWire expects will cause a problem. Some things to look for are: + Time/Date dependent information is part of the prompt EG: "(23 minutes left) COMMAND:" this should be changed to "COMMAND:" + Spaces where they do not belong + Odd control (^) characters + Line noise + The system prompt changed since you learned the script! ‚ïê‚ïê‚ïê 15. Host mode script ‚ïê‚ïê‚ïê Host mode script LiveWire 2.2 includes a Host Mode REXX script. The host mode script allows a computer to accept incoming calls. Callers can access the remote computer and do the following functions: - Transfer files - Send messages - Chat with you The host mode included is by intended for simple purposes only and is not robust or complete enough to serve as a full bulletin board or service. The host might be useful if you have a co-worker or friend who needs to call up to your system and get a file. In addition, he might also leave you a short message. The host could also be useful if you frequently exchange files from your home to the office via modem. The host is also a good example of how to program REXX scripts under LiveWire. To start the host most you must invoke it from LiveWire's command menu. The only parameter it recognizes is "LOCAL". If you type LOCAL as a parameter, the Host Mode will not wait for an incoming call, but instead will allow you to login locally. Host mode expects that the modem is setup correctly. Before running host mode make sure that: 1. The modem is NOT in auto-answer mode 2. The modem returns text response codes 3. The modem speed is set properly 4. If necessary, the modem's port speed is locked properly By default the host stores its messages and files in the LiveWire directory in the HSTFILES and HSTMSGS directories, which are automatically created by the script. These directories can be changed using the sysop menu inside the host. The default sysop password is "PASSWORD." If you have a special need that the host mode script does not address, feel free to modify the script. The script is not copyrighted, so any changes made may be re-distributed freely. ‚ïê‚ïê‚ïê 16. Reporting bugs and suggestions ‚ïê‚ïê‚ïê Reporting bugs and suggestions DataMirage Software is committed to developing and delivering quality, bug-free software that meets your needs. Our bug database allows us to track each bug and suggestion individually. This bug database will be available in January 1994 to callers of the DataMirage BBS. Callers will be able to query for bugs and submit new bugs or suggestions directly to our database. Later, they can call back and view the progress being made on the bug and the release in which it will be fixed. We still accept bugs and suggestions from internet, CompUServe, and Prodigy. All bugs submitted must be in the format following. Bugs not in this format are often ambiguous, so please follow this format as closely as possible and provide as much detailed information as possible. Please note, only one bug or suggestion per form. Submission addresses: Internet : 73631,1233@compuserve.com CompUServe : 73631,1233 LiveWire Bug Report 585 Hyde Park Drive San Jose, CA 95136 Bug Submission Form Submitter First Name : Submitter Last Name : Submitter Phone # : Submitter EMAIL : One-line description : Severity of bug (1=who cares? - 4=critical crash) : Version of LiveWire : Steps to reproduce bug (many lines) : Complete description of bug or suggestion (many lines) : Have you tested this against other communications software? Describe your hardware setup, if necessary: - CPU - UART type - Modem manufacturer - Remote host ‚ïê‚ïê‚ïê 17. Registration and support ‚ïê‚ïê‚ïê Registration and support LiveWire 2.2 shareware license agreement This agreement replaces all previous versions of LiveWire Communications license agreements. LiveWire is NOT free software! LiveWire is marketed under the shareware marketing concept. You may use LiveWire for 30 days, after which you are obligated to either register this software or discontinue use of the software. The fee for registration is nominal and brings a lot of benefits. If you register once, you will never have to buy another shareware version of LiveWire. All future versions of LiveWire marketed under the shareware concept can be registered with your serial number -- even if the registration prices go up. You also get free (except for long distance or toll charges) support through the DataMirage Bulletin Board System. By using this software you are agreeing to the above terms. Basic registration is $35 That includes: - Your registration number - Support through the DataMirage BBS Extended registration is $45 That includes: - Your registration number - A registered copy of the latest version of LiveWire - Support through the DataMirage BBS Complete registration is $65 That includes: - Your registration number - A registered copy of the latest version of LiveWire Support - Support through DataMirage BBS - A laser printed manual, identical to the one provided with the 2.2 release to register, mail the registration blank on the following page to: DataMirage Software 585 Hyde Park DriveSan Jose, CA 95136 ‚ïê‚ïê‚ïê 18. Registration by credit card ‚ïê‚ïê‚ïê Registration by credit card Starting with version 2.2 of LiveWire, credit card registration is available through the Public Shareware Library (PSL). CREDIT CARD ORDERS ONLY: You can order with MC, Visa, Amex, or Discover from Public (software) Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398 or by CIS Email to 71355,470 or by Internet Email to 71355,470@compuserve.com. You can also mail credit card orders to PsL at P.O.Box 35705, Houston, TX 77235-5705. PsL can take orders via our 800#, non-800#, CIS#, and FAX#. Operators are available from 7:00 a.m. to 7:00 p.m. CST Monday-Friday and normally from 7:00 a.m. to 4:00 p.m. on weekends. THE ABOVE NUMBERS ARE FOR ORDERS ONLY Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc, must be directed to: DataMirage Software 585 Hyde Park Drive San Jose, CA 95136 BBS #: 714-856-2071 To insure that you get the latest version, PsL will notify DataMirage the day of your order and we will ship the product directly to you. Software Order #11300 ‚ïê‚ïê‚ïê 19. Registration form ‚ïê‚ïê‚ïê Registration form (print me!) Filling out your name, address, and phone number is a requirement. Your name will be used to personalize your serial number. Name _________________________________ Address _________________________________ _________________________________ _________________________________ Phone # (_____)_________-________________ QUANTITY ( ) $35 Basic Registration = registration # ( ) $45 Extended Registration = registration # + newest version ( ) $65 Complete Registration = registration # + newest version + printed manual SUB TOTAL ________ $5 shipping ________ (USA addresses excluded) + TAX (8.75%) ________ (California residents only!) TOTAL COST ________ I only accept US currency, US money orders, and checks through the mail. If you send a purchase order, please make it clear where the invoice should be mailed.